أداة MCP
نشر صورة واحدة من URL
sosoapi_post_image_urlأرسِل منشور URL الصورة الكامل مرة، مع media فارغة. تُعدّه الخلفية وتنشره حتى بعد الانقطاع. تُعيد النشر النهائي إن توفر خلال 35 ثانية، وإلا معرّفاً دائماً؛ لا تُعد الإرسال بمفتاح جديد. يلزم operate و publish. حقلا الوقت المحلي/DST معاً. import_id لاستئناف العملاء القدامى فقط.
اقرأ بصيغة Markdownالملفات التعريفية ووسائل النقل
الملفات التعريفية: core, full · وسائل النقل: stdio, http
اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.
الأذونات والآثار الجانبية
تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.
{
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}- /studio-api/scheduled-posts/create-image-url: agent:publish · النتيجة النهائية للنشر
حقول الإدخال
تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.
| الحقل / الفرع | النوع / مطلوب | القيود |
|---|---|---|
$ | objectمطلوب في العنصر الأب |
|
source_url | stringمطلوب في العنصر الأب |
|
post | objectمطلوب في العنصر الأب |
|
post.workspace_id | stringمطلوب في العنصر الأب |
|
post.project_id | string | nullاختياري / عنصر | — |
post.project_idanyOf 1 | stringاختياري / عنصر |
|
post.project_idanyOf 2 | nullاختياري / عنصر | — |
post.social_account_id | stringمطلوب في العنصر الأب |
|
post.caption | string | nullاختياري / عنصر | — |
post.captionanyOf 1 | stringاختياري / عنصر |
|
post.captionanyOf 2 | nullاختياري / عنصر | — |
post.hashtags | arrayاختياري / عنصر |
|
post.hashtags[] | stringاختياري / عنصر |
|
post.media | arrayاختياري / عنصر |
|
post.media[] | objectاختياري / عنصر |
|
post.media[].kind | stringمطلوب في العنصر الأب |
|
post.media[].url | stringمطلوب في العنصر الأب |
|
post.media[].cover_url | string | nullاختياري / عنصر | — |
post.media[].cover_urlanyOf 1 | stringاختياري / عنصر |
|
post.media[].cover_urlanyOf 2 | nullاختياري / عنصر | — |
post.media[].cover_asset_id | integer | nullاختياري / عنصر | — |
post.media[].cover_asset_idanyOf 1 | integerاختياري / عنصر |
|
post.media[].cover_asset_idanyOf 2 | nullاختياري / عنصر | — |
post.media[].asset_id | integer | nullاختياري / عنصر | — |
post.media[].asset_idanyOf 1 | integerاختياري / عنصر |
|
post.media[].asset_idanyOf 2 | nullاختياري / عنصر | — |
post.media[].mime_type | string | nullاختياري / عنصر | — |
post.media[].mime_typeanyOf 1 | stringاختياري / عنصر |
|
post.media[].mime_typeanyOf 2 | nullاختياري / عنصر | — |
post.link_url | string | nullاختياري / عنصر | — |
post.link_urlanyOf 1 | stringاختياري / عنصر |
|
post.link_urlanyOf 2 | nullاختياري / عنصر | — |
post.provider_payload | objectمطلوب في العنصر الأب |
|
post.provider_payload.platform | stringمطلوب في العنصر الأب |
|
post.provider_payload.publish_options | objectمطلوب في العنصر الأب |
|
post.provider_payload.publish_options.post_type | stringمطلوب في العنصر الأب |
|
post.provider_payload.publish_options.* | any JSON valueاختياري / عنصر | — |
post.scheduled_at | stringمطلوب في العنصر الأب |
|
post.display_timezone | stringاختياري / عنصر |
|
post.local_scheduled_at | stringاختياري / عنصر |
|
post.schedule_dst_disambiguation | stringاختياري / عنصر |
|
post.expires_at | string | nullاختياري / عنصر | — |
post.expires_atanyOf 1 | stringاختياري / عنصر |
|
post.expires_atanyOf 2 | nullاختياري / عنصر | — |
post.source_ref | object | nullاختياري / عنصر | — |
post.source_refanyOf 1 | objectاختياري / عنصر |
|
post.source_ref.*anyOf 1 | any JSON valueاختياري / عنصر | — |
post.source_refanyOf 2 | nullاختياري / عنصر | — |
post.automatic_retry_enabled | booleanاختياري / عنصر | — |
post.idempotency_key | stringمطلوب في العنصر الأب |
|
import_id | stringاختياري / عنصر | استخدم import_id المُعاد لعنوان URL ومساحة العمل وقصد المستخدم أنفسها فقط.
|
مخطط JSON Schema الكامل
{
"type": "object",
"properties": {
"source_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"post": {
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"social_account_id": {
"type": "string",
"format": "uuid"
},
"caption": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"type": "null"
}
]
},
"hashtags": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
}
},
"media": {
"maxItems": 0,
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
},
"url": {
"type": "string",
"format": "uri"
},
"cover_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"cover_asset_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"asset_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"mime_type": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 160
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"url"
],
"additionalProperties": false
}
},
"link_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"provider_payload": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"threads",
"instagram",
"facebook"
]
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"IMAGE",
"STORY_IMAGE"
]
}
},
"required": [
"post_type"
],
"additionalProperties": {}
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
"scheduled_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"display_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"local_scheduled_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
},
"schedule_dst_disambiguation": {
"type": "string",
"enum": [
"exact",
"earlier",
"later"
]
},
"expires_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"automatic_retry_enabled": {
"type": "boolean"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 160
}
},
"required": [
"workspace_id",
"social_account_id",
"provider_payload",
"scheduled_at",
"idempotency_key"
],
"additionalProperties": false
},
"import_id": {
"description": "Use only the import_id returned for this same URL, Workspace and user intent.",
"type": "string",
"format": "uuid"
}
},
"required": [
"source_url",
"post"
],
"additionalProperties": false
}مخرجات منظّمة
يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.
تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.
| الحقل / الفرع | النوع / مطلوب | القيود |
|---|---|---|
$ | objectمطلوب في العنصر الأب |
|
stage | stringمطلوب في العنصر الأب |
|
import_id | stringمطلوب في العنصر الأب |
|
completion | stringاختياري / عنصر |
|
scheduled_post | object | nullمطلوب في العنصر الأب | — |
scheduled_postanyOf 1 | objectمطلوب في العنصر الأب |
|
scheduled_post.postanyOf 1 | objectمطلوب في العنصر الأب |
|
scheduled_post.post.idanyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.workspace_idanyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.social_account_idanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.social_account_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.social_account_idanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.platformanyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.destinationanyOf 1 | objectمطلوب في العنصر الأب |
|
scheduled_post.post.destination.social_account_idanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.destination.social_account_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.destination.social_account_idanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.destination.platformanyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.destination.platform_user_idanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.destination.platform_user_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.destination.platform_user_idanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.destination.account_labelanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.destination.account_labelanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.destination.account_labelanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.captionanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.captionanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.captionanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.hashtagsanyOf 1 | arrayمطلوب في العنصر الأب | — |
scheduled_post.post.hashtags[]anyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.mediaanyOf 1 | arrayمطلوب في العنصر الأب | — |
scheduled_post.post.media[]anyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.media[].kindanyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.media[].urlanyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.media[].cover_urlanyOf 1 | string | nullاختياري / عنصر | — |
scheduled_post.post.media[].cover_urlanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.media[].cover_urlanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.media[].cover_asset_idanyOf 1 | integer | nullاختياري / عنصر | — |
scheduled_post.post.media[].cover_asset_idanyOf 1 / anyOf 1 | integerاختياري / عنصر |
|
scheduled_post.post.media[].cover_asset_idanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.media[].asset_idanyOf 1 | integer | nullاختياري / عنصر | — |
scheduled_post.post.media[].asset_idanyOf 1 / anyOf 1 | integerاختياري / عنصر |
|
scheduled_post.post.media[].asset_idanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.media[].mime_typeanyOf 1 | string | nullاختياري / عنصر | — |
scheduled_post.post.media[].mime_typeanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.media[].mime_typeanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.media[].preview_urlanyOf 1 | string | nullاختياري / عنصر | URL قراءة مؤقت ومفوّض؛ احتفظ بـ url بوصفه هوية وسائط Scheduled Post المخزّنة. — |
scheduled_post.post.media[].preview_urlanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.media[].preview_urlanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.media[].cover_preview_urlanyOf 1 | string | nullاختياري / عنصر | URL قراءة مؤقت ومفوّض للغلاف؛ احتفظ بـ cover_url بوصفه هوية الوسائط المخزّنة. — |
scheduled_post.post.media[].cover_preview_urlanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.media[].cover_preview_urlanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.media[].preview_expires_atanyOf 1 | string | nullاختياري / عنصر | — |
scheduled_post.post.media[].preview_expires_atanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.media[].preview_expires_atanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.link_urlanyOf 1 | string | nullاختياري / عنصر | — |
scheduled_post.post.link_urlanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.link_urlanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.publish_optionsanyOf 1 | objectمطلوب في العنصر الأب |
|
scheduled_post.post.publish_options.post_typeanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.location_idanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.share_to_feedanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.collaboratorsanyOf 1 | arrayاختياري / عنصر |
|
scheduled_post.post.publish_options.collaborators[]anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.first_commentanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.topic_taganyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.thumb_offset_msanyOf 1 | integerاختياري / عنصر |
|
scheduled_post.post.publish_options.titleanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.youtube_privacy_statusanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.youtube_category_idanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.youtube_contains_synthetic_mediaanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.descriptionanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.category_idanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.privacy_statusanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.cancellation_modeanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.tagsanyOf 1 | arrayاختياري / عنصر | — |
scheduled_post.post.publish_options.tags[]anyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.default_languageanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.localizationsanyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.localizations.*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.licenseanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.embeddableanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.public_stats_viewableanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.self_declared_made_for_kidsanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.contains_synthetic_mediaanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.has_paid_product_placementanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.recording_dateanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.notify_subscribersanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.thumbnail_asset_idanyOf 1 | integerاختياري / عنصر |
|
scheduled_post.post.publish_options.surface_expectationanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.brand_partneranyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.brand_partner.*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.cover_asset_idanyOf 1 | integerاختياري / عنصر |
|
scheduled_post.post.publish_options.audio_nameanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.trial_paramsanyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.trial_params.*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.is_ai_generatedanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.branded_content_sponsor_idsanyOf 1 | arrayاختياري / عنصر | — |
scheduled_post.post.publish_options.branded_content_sponsor_ids[]anyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.is_paid_partnershipanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.media_optionsanyOf 1 | arrayاختياري / عنصر | — |
scheduled_post.post.publish_options.media_options[]anyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.media_options[].*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.reply_to_idanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.quote_post_idanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.repost_target_idanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.reply_controlanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.enable_reply_approvalsanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.link_attachmentanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.poll_attachmentanyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.poll_attachment.*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.gif_attachmentanyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.gif_attachment.*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.text_attachmentanyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.text_attachment.*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.text_entitiesanyOf 1 | arrayاختياري / عنصر | — |
scheduled_post.post.publish_options.text_entities[]anyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.text_entities[].*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.is_spoiler_mediaanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.is_ghost_postanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.allowlisted_country_codesanyOf 1 | arrayاختياري / عنصر | — |
scheduled_post.post.publish_options.allowlisted_country_codes[]anyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.crossreshare_to_iganyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.crossreshare_to_ig_dark_modeanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.auto_publish_textanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.publication_modeanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.backdated_timeanyOf 1 | numberاختياري / عنصر | — |
scheduled_post.post.publish_options.backdated_time_granularityanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.publish_options.placeanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.feed_targetinganyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.feed_targeting.*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.targetinganyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.targeting.*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.child_attachmentsanyOf 1 | arrayاختياري / عنصر | — |
scheduled_post.post.publish_options.child_attachments[]anyOf 1 | objectاختياري / عنصر |
|
scheduled_post.post.publish_options.child_attachments[].*anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.publish_options.multi_share_end_cardanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.multi_share_optimizedanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.unpublished_content_typeanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.no_storyanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.publish_options.crossposted_video_idanyOf 1 | stringاختياري / عنصر | — |
scheduled_post.post.publish_options.sphericalanyOf 1 | booleanاختياري / عنصر | — |
scheduled_post.post.scheduled_atanyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.display_timezoneanyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.local_scheduled_atanyOf 1 | string | nullاختياري / عنصر | — |
scheduled_post.post.local_scheduled_atanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.local_scheduled_atanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.schedule_timezoneanyOf 1 | string | nullاختياري / عنصر | — |
scheduled_post.post.schedule_timezoneanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.schedule_timezoneanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.schedule_dst_disambiguationanyOf 1 | string | nullاختياري / عنصر | — |
scheduled_post.post.schedule_dst_disambiguationanyOf 1 / anyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.schedule_dst_disambiguationanyOf 1 / anyOf 2 | nullاختياري / عنصر | — |
scheduled_post.post.schedule_intent_stateanyOf 1 | stringاختياري / عنصر |
|
scheduled_post.post.expires_atanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.expires_atanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.expires_atanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.statusanyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.versionanyOf 1 | integerمطلوب في العنصر الأب |
|
scheduled_post.post.automatic_retry_enabledanyOf 1 | booleanمطلوب في العنصر الأب | — |
scheduled_post.post.delete_requested_atanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.delete_requested_atanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.delete_requested_atanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.published_atanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.published_atanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.published_atanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.deleted_atanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.deleted_atanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.deleted_atanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.provider_post_idanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.provider_post_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.provider_post_idanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.permalinkanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.permalinkanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.permalinkanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.created_atanyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.updated_atanyOf 1 | stringمطلوب في العنصر الأب | — |
scheduled_post.post.project_idanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.project_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.project_idanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.batch_idanyOf 1 | string | nullمطلوب في العنصر الأب | — |
scheduled_post.post.batch_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
scheduled_post.post.batch_idanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.post.source_refanyOf 1 | object | nullمطلوب في العنصر الأب | — |
scheduled_post.post.source_refanyOf 1 / anyOf 1 | objectمطلوب في العنصر الأب |
|
scheduled_post.post.source_ref.*anyOf 1 / anyOf 1 | any JSON valueاختياري / عنصر | — |
scheduled_post.post.source_refanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
scheduled_post.dedupedanyOf 1 | booleanمطلوب في العنصر الأب | — |
scheduled_postanyOf 2 | nullمطلوب في العنصر الأب | — |
retry_after_seconds | integerاختياري / عنصر |
|
resume_arguments | objectاختياري / عنصر |
|
resume_arguments.* | any JSON valueاختياري / عنصر | — |
مخطط JSON Schema الكامل
{
"type": "object",
"properties": {
"stage": {
"type": "string",
"enum": [
"media_pending",
"media_failed",
"scheduled"
]
},
"import_id": {
"type": "string",
"format": "uuid"
},
"completion": {
"type": "string",
"enum": [
"pending",
"terminal"
]
},
"scheduled_post": {
"anyOf": [
{
"type": "object",
"properties": {
"post": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"social_account_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"platform": {
"type": "string",
"enum": [
"instagram",
"threads",
"facebook",
"youtube",
"x"
]
},
"destination": {
"type": "object",
"properties": {
"social_account_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"platform": {
"type": "string",
"enum": [
"instagram",
"threads",
"facebook",
"youtube",
"x"
]
},
"platform_user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"account_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"social_account_id",
"platform",
"platform_user_id",
"account_label"
],
"additionalProperties": false
},
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hashtags": {
"type": "array",
"items": {
"type": "string"
}
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
},
"url": {
"type": "string",
"format": "uri"
},
"cover_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"cover_asset_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"asset_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"mime_type": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 160
},
{
"type": "null"
}
]
},
"preview_url": {
"description": "Temporary authorized read URL; keep url as persisted Scheduled Post media identity.",
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"cover_preview_url": {
"description": "Temporary authorized cover read URL; keep cover_url as persisted media identity.",
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"preview_expires_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"url"
],
"additionalProperties": false
}
},
"link_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"LINK",
"IMAGE",
"MULTI_IMAGE",
"VIDEO",
"CAROUSEL",
"REELS",
"STORY_IMAGE",
"STORY_VIDEO",
"REPOST",
"SHORT"
]
},
"location_id": {
"type": "string",
"minLength": 1
},
"share_to_feed": {
"type": "boolean"
},
"collaborators": {
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"first_comment": {
"type": "string",
"minLength": 1,
"maxLength": 2200
},
"topic_tag": {
"type": "string",
"minLength": 1
},
"thumb_offset_ms": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"type": "string",
"maxLength": 255
},
"youtube_privacy_status": {
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtube_category_id": {
"type": "string",
"pattern": "^\\d+$"
},
"youtube_contains_synthetic_media": {
"type": "boolean"
},
"description": {
"type": "string",
"maxLength": 5000
},
"category_id": {
"type": "string",
"pattern": "^\\d+$"
},
"privacy_status": {
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"cancellation_mode": {
"type": "string",
"enum": [
"DELETE",
"UNSCHEDULE_KEEP_PRIVATE"
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"default_language": {
"type": "string"
},
"localizations": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"license": {
"type": "string",
"enum": [
"youtube",
"creativeCommon"
]
},
"embeddable": {
"type": "boolean"
},
"public_stats_viewable": {
"type": "boolean"
},
"self_declared_made_for_kids": {
"type": "boolean"
},
"contains_synthetic_media": {
"type": "boolean"
},
"has_paid_product_placement": {
"type": "boolean"
},
"recording_date": {
"type": "string"
},
"notify_subscribers": {
"type": "boolean"
},
"thumbnail_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"surface_expectation": {
"type": "string",
"const": "SHORT"
},
"brand_partner": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"cover_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"audio_name": {
"type": "string"
},
"trial_params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"is_ai_generated": {
"type": "boolean"
},
"branded_content_sponsor_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"is_paid_partnership": {
"type": "boolean"
},
"media_options": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"reply_to_id": {
"type": "string"
},
"quote_post_id": {
"type": "string"
},
"repost_target_id": {
"type": "string"
},
"reply_control": {
"type": "string"
},
"enable_reply_approvals": {
"type": "boolean"
},
"link_attachment": {
"type": "string",
"format": "uri"
},
"poll_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"gif_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"text_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"text_entities": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"is_spoiler_media": {
"type": "boolean"
},
"is_ghost_post": {
"type": "boolean"
},
"allowlisted_country_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"crossreshare_to_ig": {
"type": "boolean"
},
"crossreshare_to_ig_dark_mode": {
"type": "boolean"
},
"auto_publish_text": {
"type": "boolean"
},
"publication_mode": {
"type": "string",
"enum": [
"PUBLISH",
"DRAFT"
]
},
"backdated_time": {
"type": "number"
},
"backdated_time_granularity": {
"type": "string",
"enum": [
"year",
"month",
"day",
"hour",
"minute"
]
},
"place": {
"type": "string"
},
"feed_targeting": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"targeting": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"child_attachments": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"multi_share_end_card": {
"type": "boolean"
},
"multi_share_optimized": {
"type": "boolean"
},
"unpublished_content_type": {
"type": "string"
},
"no_story": {
"type": "boolean"
},
"crossposted_video_id": {
"type": "string"
},
"spherical": {
"type": "boolean"
}
},
"additionalProperties": false
},
"scheduled_at": {
"type": "string"
},
"display_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"local_scheduled_at": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
},
{
"type": "null"
}
]
},
"schedule_timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 80
},
{
"type": "null"
}
]
},
"schedule_dst_disambiguation": {
"anyOf": [
{
"type": "string",
"enum": [
"exact",
"earlier",
"later"
]
},
{
"type": "null"
}
]
},
"schedule_intent_state": {
"type": "string",
"enum": [
"verified",
"legacy_unverified"
]
},
"expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"scheduled",
"publishing",
"published",
"failed",
"expired",
"needs_reschedule",
"cancelled",
"deleted"
]
},
"version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"automatic_retry_enabled": {
"type": "boolean"
},
"delete_requested_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"published_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"deleted_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_post_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"permalink": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"batch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"workspace_id",
"social_account_id",
"platform",
"destination",
"caption",
"hashtags",
"media",
"publish_options",
"scheduled_at",
"display_timezone",
"expires_at",
"status",
"version",
"automatic_retry_enabled",
"delete_requested_at",
"published_at",
"deleted_at",
"provider_post_id",
"permalink",
"created_at",
"updated_at",
"project_id",
"batch_id",
"source_ref"
],
"additionalProperties": false
},
"deduped": {
"type": "boolean"
}
},
"required": [
"post",
"deduped"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"retry_after_seconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"resume_arguments": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"stage",
"import_id",
"scheduled_post"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}مثال لاستدعاء أداة
تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.
{
"name": "sosoapi_post_image_url",
"arguments": {
"source_url": "https://example.com/media.png",
"post": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"social_account_id": "11111111-1111-4111-8111-111111111111",
"provider_payload": {
"platform": "threads",
"publish_options": {
"post_type": "IMAGE"
}
},
"scheduled_at": "2099-01-15T09:00:00Z",
"idempotency_key": "example-intent-0001",
"media": []
}
}
}structuredContent
{
"stage": "media_pending",
"import_id": "11111111-1111-4111-8111-111111111111",
"scheduled_post": null
}