تفضيلات الخصوصية

الوظائف الضرورية

مطلوبة للأمان ووظائف الموقع الأساسية.

مفعّلة دائمًا

تشخيصات Landing وإعادة العرض مع إخفاء المحتوى

يقيس الزيارات العامة والمغادرة قبل الإكمال والتفاعلات مع روابط التسجيل باستخدام معرّف مجهول الهوية خاص بعلامة التبويب فقط، دون ربطه بحساب. تُخفى جميع النصوص وتُحظر النماذج.

تحليلات الاستخدام الاختيارية

هل تسمح بتحليلات استخدام PostHog؟ يمكنك تغيير اختيارك في أي وقت من التذييل.

السماح أيضاً بتسجيل الجلسات لإعادة عرضها على هذا الموقع العام

تُظهر إعادة عرض الجلسات في الوضع الاختياري عبر المواقع الصفحات العامة والتفاعلات، مع إخفاء المدخلات والمحتوى الخاص. إعادة عرض الجلسات في التطبيق خيار مستقل.

يتطلب التحليلات الاختيارية؛ إعادة العرض في هذا الوضع عبر المواقع معطّلة افتراضيًا. يعمل وضع Landing أعلاه بشكل منفصل.

كيف نستخدم البيانات

يخزّن وضع Landing الافتراضي معرّفًا مجهول الهوية في sessionStorage لعلامة التبويب هذه فقط، دون ربطه بالتطبيق أو الحسابات أو المعرّف الاختياري عبر المواقع. يؤدي السماح بالتحليلات الاختيارية إلى استخدام معرّف مستقل دون ربط سجلات Landing السابقة به.

السماح بالتحليلات الاختيارية يتيح لـ PostHog مشاركة ملف تعريف ارتباط مجهول الهوية بين هذا الموقع وتطبيقنا، مع استخدام تخزين المتصفح المحلي في كل موقع. بموافقتك، يمكن ربط زيارة جرى التحقّق منها في علامة التبويب نفسها بحسابك الجديد بعد تأكيد التسجيل.

إعادة عرض الجلسات في الوضع الاختياري عبر المواقع معطّلة افتراضيًا. أزل تحديد خيار إعادة العرض الخاص به واحفظ لإيقاف التسجيلات الجديدة في ذلك الوضع؛ وأوقف تشخيصات Landing وإعادة العرض مع إخفاء المحتوى بشكل منفصل أعلاه. لا تغيّر هذه الاختيارات إعدادات الحساب.

إشعار الخصوصية وقياس Cloudflare التجميعي المستقل.

لا تفعّل تحليلات المتصفح تحليلات الحساب.

SosoAPI
ابدأ مجانًا
AR
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
ابدأ مجانًا

يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

أداة MCP

إعداد إجراء إعلاني

sosoapi_ads_actions_prepare

تثبيت أمر محدد من النوع campaign/adset/ad/creative/saved-audience وآثاره التي تمت مراجعتها. تبدأ العناصر المنشأة بحالة PAUSED؛ ويتطلب التفعيل أو التأثير في الميزانية صلاحية منفصلة للتنفيذ الفعلي.

اقرأ بصيغة Markdown

الملفات التعريفية ووسائل النقل

الملفات التعريفية: full · وسائل النقل: stdio, http

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

حقول الإدخال

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الإدخال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
advertising_account_idstringمطلوب في العنصر الأب
  • format: "uuid"
mutation_idstringمطلوب في العنصر الأب
  • format: "uuid"
commandobjectمطلوب في العنصر الأب—
commandanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 1stringمطلوب في العنصر الأب
  • enum: ["create_campaign"]
command.nameanyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
command.budgetanyOf 1objectاختياري / عنصر
  • additionalProperties: false
command.budget.kindanyOf 1stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
command.budget.amount_minoranyOf 1stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
command.objectiveanyOf 1stringمطلوب في العنصر الأب
  • enum: ["OUTCOME_AWARENESS","OUTCOME_ENGAGEMENT","OUTCOME_LEADS","OUTCOME_SALES","OUTCOME_TRAFFIC","OUTCOME_APP_PROMOTION"]
command.special_ad_categoriesanyOf 1arrayاختياري / عنصر
  • maxItems: 4
command.special_ad_categories[]anyOf 1stringاختياري / عنصر
  • enum: ["CREDIT","EMPLOYMENT","HOUSING","ISSUES_ELECTIONS_POLITICS"]
command.statusanyOf 1stringاختياري / عنصر
  • enum: ["PAUSED"]
commandanyOf 2objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 2stringمطلوب في العنصر الأب
  • enum: ["update_campaign"]
command.object_idanyOf 2stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
command.nameanyOf 2stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
command.budgetanyOf 2objectاختياري / عنصر
  • additionalProperties: false
command.budget.kindanyOf 2stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
command.budget.amount_minoranyOf 2stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
command.statusanyOf 2stringاختياري / عنصر
  • enum: ["ACTIVE","PAUSED","ARCHIVED"]
commandanyOf 3objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 3stringمطلوب في العنصر الأب
  • enum: ["create_adset"]
command.campaign_idanyOf 3stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
command.nameanyOf 3stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
command.budgetanyOf 3objectاختياري / عنصر
  • additionalProperties: false
command.budget.kindanyOf 3stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
command.budget.amount_minoranyOf 3stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
command.targetinganyOf 3objectمطلوب في العنصر الأب
  • additionalProperties: false
command.targeting.geo_locationsanyOf 3objectمطلوب في العنصر الأب
  • additionalProperties: false
command.targeting.geo_locations.countriesanyOf 3arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 25
command.targeting.geo_locations.countries[]anyOf 3stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
command.targeting.age_minanyOf 3integerاختياري / عنصر
  • minimum: 18
  • maximum: 65
command.targeting.age_maxanyOf 3integerاختياري / عنصر
  • minimum: 18
  • maximum: 65
command.targeting.gendersanyOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
command.targeting.genders[]anyOf 3numberاختياري / عنصر—
command.targeting.genders[]anyOf 3 / anyOf 1numberاختياري / عنصر
  • enum: [1]
command.targeting.genders[]anyOf 3 / anyOf 2numberاختياري / عنصر
  • enum: [2]
command.targeting.localesanyOf 3arrayاختياري / عنصر
  • maxItems: 25
command.targeting.locales[]anyOf 3integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
command.targeting.publisher_platformsanyOf 3arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 3
command.targeting.publisher_platforms[]anyOf 3stringاختياري / عنصر
  • enum: ["facebook","instagram","threads"]
command.targeting.facebook_positionsanyOf 3arrayاختياري / عنصر
  • maxItems: 4
command.targeting.facebook_positions[]anyOf 3stringاختياري / عنصر
  • enum: ["feed","story","facebook_reels","video_feeds"]
command.targeting.instagram_positionsanyOf 3arrayاختياري / عنصر
  • maxItems: 4
command.targeting.instagram_positions[]anyOf 3stringاختياري / عنصر
  • enum: ["stream","story","reels","explore"]
command.targeting.threads_positionsanyOf 3arrayاختياري / عنصر
  • maxItems: 1
command.targeting.threads_positions[]anyOf 3stringاختياري / عنصر
  • enum: ["threads_stream"]
command.targeting.custom_audience_idsanyOf 3arrayاختياري / عنصر
  • maxItems: 4
command.targeting.custom_audience_ids[]anyOf 3stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.targeting.excluded_custom_audience_idsanyOf 3arrayاختياري / عنصر
  • maxItems: 4
command.targeting.excluded_custom_audience_ids[]anyOf 3stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.billing_eventanyOf 3stringمطلوب في العنصر الأب
  • enum: ["IMPRESSIONS","LINK_CLICKS"]
command.optimization_goalanyOf 3stringمطلوب في العنصر الأب
  • enum: ["REACH","IMPRESSIONS","LINK_CLICKS","LANDING_PAGE_VIEWS","OFFSITE_CONVERSIONS","LEAD_GENERATION"]
command.bid_strategyanyOf 3stringاختياري / عنصر
  • enum: ["LOWEST_COST_WITHOUT_CAP"]
command.start_timeanyOf 3stringاختياري / عنصر
  • 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)))$"
command.end_timeanyOf 3stringاختياري / عنصر
  • 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)))$"
command.promoted_objectanyOf 3objectاختياري / عنصر
  • additionalProperties: false
command.promoted_object.page_idanyOf 3stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.promoted_object.pixel_idanyOf 3stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.promoted_object.custom_event_typeanyOf 3stringاختياري / عنصر
  • enum: ["PURCHASE","LEAD","COMPLETE_REGISTRATION","ADD_TO_CART"]
command.statusanyOf 3stringاختياري / عنصر
  • enum: ["PAUSED"]
commandanyOf 4objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 4stringمطلوب في العنصر الأب
  • enum: ["update_adset"]
command.object_idanyOf 4stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
command.nameanyOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
command.budgetanyOf 4objectاختياري / عنصر
  • additionalProperties: false
command.budget.kindanyOf 4stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
command.budget.amount_minoranyOf 4stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
command.statusanyOf 4stringاختياري / عنصر
  • enum: ["ACTIVE","PAUSED","ARCHIVED"]
command.targetinganyOf 4objectاختياري / عنصر
  • additionalProperties: false
command.targeting.geo_locationsanyOf 4objectمطلوب في العنصر الأب
  • additionalProperties: false
command.targeting.geo_locations.countriesanyOf 4arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 25
command.targeting.geo_locations.countries[]anyOf 4stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
command.targeting.age_minanyOf 4integerاختياري / عنصر
  • minimum: 18
  • maximum: 65
command.targeting.age_maxanyOf 4integerاختياري / عنصر
  • minimum: 18
  • maximum: 65
command.targeting.gendersanyOf 4arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
command.targeting.genders[]anyOf 4numberاختياري / عنصر—
command.targeting.genders[]anyOf 4 / anyOf 1numberاختياري / عنصر
  • enum: [1]
command.targeting.genders[]anyOf 4 / anyOf 2numberاختياري / عنصر
  • enum: [2]
command.targeting.localesanyOf 4arrayاختياري / عنصر
  • maxItems: 25
command.targeting.locales[]anyOf 4integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
command.targeting.publisher_platformsanyOf 4arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 3
command.targeting.publisher_platforms[]anyOf 4stringاختياري / عنصر
  • enum: ["facebook","instagram","threads"]
command.targeting.facebook_positionsanyOf 4arrayاختياري / عنصر
  • maxItems: 4
command.targeting.facebook_positions[]anyOf 4stringاختياري / عنصر
  • enum: ["feed","story","facebook_reels","video_feeds"]
command.targeting.instagram_positionsanyOf 4arrayاختياري / عنصر
  • maxItems: 4
command.targeting.instagram_positions[]anyOf 4stringاختياري / عنصر
  • enum: ["stream","story","reels","explore"]
command.targeting.threads_positionsanyOf 4arrayاختياري / عنصر
  • maxItems: 1
command.targeting.threads_positions[]anyOf 4stringاختياري / عنصر
  • enum: ["threads_stream"]
command.targeting.custom_audience_idsanyOf 4arrayاختياري / عنصر
  • maxItems: 4
command.targeting.custom_audience_ids[]anyOf 4stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.targeting.excluded_custom_audience_idsanyOf 4arrayاختياري / عنصر
  • maxItems: 4
command.targeting.excluded_custom_audience_ids[]anyOf 4stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.start_timeanyOf 4stringاختياري / عنصر
  • 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)))$"
command.end_timeanyOf 4stringاختياري / عنصر
  • 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)))$"
commandanyOf 5objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 5stringمطلوب في العنصر الأب
  • enum: ["create_ad"]
command.nameanyOf 5stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
command.adset_idanyOf 5stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
command.creative_idanyOf 5stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
command.statusanyOf 5stringاختياري / عنصر
  • enum: ["PAUSED"]
commandanyOf 6objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 6stringمطلوب في العنصر الأب
  • enum: ["update_ad"]
command.object_idanyOf 6stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
command.nameanyOf 6stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
command.creative_idanyOf 6stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.statusanyOf 6stringاختياري / عنصر
  • enum: ["ACTIVE","PAUSED","ARCHIVED"]
commandanyOf 7objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 7stringمطلوب في العنصر الأب
  • enum: ["create_creative"]
command.nameanyOf 7stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
command.object_story_specanyOf 7objectاختياري / عنصر
  • additionalProperties: false
command.object_story_spec.page_idanyOf 7stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
command.object_story_spec.instagram_user_idanyOf 7stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.object_story_spec.link_dataanyOf 7objectمطلوب في العنصر الأب
  • additionalProperties: false
command.object_story_spec.link_data.linkanyOf 7stringمطلوب في العنصر الأب
  • format: "uri"
  • maxLength: 2048
command.object_story_spec.link_data.messageanyOf 7stringمطلوب في العنصر الأب
  • maxLength: 5000
command.object_story_spec.link_data.nameanyOf 7stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
command.object_story_spec.link_data.image_hashanyOf 7stringمطلوب في العنصر الأب
  • pattern: "^[a-fA-F0-9]{16,128}$"
command.object_story_spec.link_data.call_to_actionanyOf 7stringاختياري / عنصر
  • enum: ["LEARN_MORE","SHOP_NOW","SIGN_UP","CONTACT_US"]
command.object_story_idanyOf 7stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}_[1-9]\\d{1,24}$"
commandanyOf 8objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 8stringمطلوب في العنصر الأب
  • enum: ["create_saved_audience"]
command.nameanyOf 8stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
command.targetinganyOf 8objectمطلوب في العنصر الأب
  • additionalProperties: false
command.targeting.geo_locationsanyOf 8objectمطلوب في العنصر الأب
  • additionalProperties: false
command.targeting.geo_locations.countriesanyOf 8arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 25
command.targeting.geo_locations.countries[]anyOf 8stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
command.targeting.age_minanyOf 8integerاختياري / عنصر
  • minimum: 18
  • maximum: 65
command.targeting.age_maxanyOf 8integerاختياري / عنصر
  • minimum: 18
  • maximum: 65
command.targeting.gendersanyOf 8arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
command.targeting.genders[]anyOf 8numberاختياري / عنصر—
command.targeting.genders[]anyOf 8 / anyOf 1numberاختياري / عنصر
  • enum: [1]
command.targeting.genders[]anyOf 8 / anyOf 2numberاختياري / عنصر
  • enum: [2]
command.targeting.localesanyOf 8arrayاختياري / عنصر
  • maxItems: 25
command.targeting.locales[]anyOf 8integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
command.targeting.publisher_platformsanyOf 8arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 3
command.targeting.publisher_platforms[]anyOf 8stringاختياري / عنصر
  • enum: ["facebook","instagram","threads"]
command.targeting.facebook_positionsanyOf 8arrayاختياري / عنصر
  • maxItems: 4
command.targeting.facebook_positions[]anyOf 8stringاختياري / عنصر
  • enum: ["feed","story","facebook_reels","video_feeds"]
command.targeting.instagram_positionsanyOf 8arrayاختياري / عنصر
  • maxItems: 4
command.targeting.instagram_positions[]anyOf 8stringاختياري / عنصر
  • enum: ["stream","story","reels","explore"]
command.targeting.threads_positionsanyOf 8arrayاختياري / عنصر
  • maxItems: 1
command.targeting.threads_positions[]anyOf 8stringاختياري / عنصر
  • enum: ["threads_stream"]
command.targeting.custom_audience_idsanyOf 8arrayاختياري / عنصر
  • maxItems: 4
command.targeting.custom_audience_ids[]anyOf 8stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.targeting.excluded_custom_audience_idsanyOf 8arrayاختياري / عنصر
  • maxItems: 4
command.targeting.excluded_custom_audience_ids[]anyOf 8stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
commandanyOf 9objectمطلوب في العنصر الأب
  • additionalProperties: false
command.operationanyOf 9stringمطلوب في العنصر الأب
  • enum: ["update_saved_audience"]
command.object_idanyOf 9stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
command.nameanyOf 9stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
command.targetinganyOf 9objectاختياري / عنصر
  • additionalProperties: false
command.targeting.geo_locationsanyOf 9objectمطلوب في العنصر الأب
  • additionalProperties: false
command.targeting.geo_locations.countriesanyOf 9arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 25
command.targeting.geo_locations.countries[]anyOf 9stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
command.targeting.age_minanyOf 9integerاختياري / عنصر
  • minimum: 18
  • maximum: 65
command.targeting.age_maxanyOf 9integerاختياري / عنصر
  • minimum: 18
  • maximum: 65
command.targeting.gendersanyOf 9arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
command.targeting.genders[]anyOf 9numberاختياري / عنصر—
command.targeting.genders[]anyOf 9 / anyOf 1numberاختياري / عنصر
  • enum: [1]
command.targeting.genders[]anyOf 9 / anyOf 2numberاختياري / عنصر
  • enum: [2]
command.targeting.localesanyOf 9arrayاختياري / عنصر
  • maxItems: 25
command.targeting.locales[]anyOf 9integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
command.targeting.publisher_platformsanyOf 9arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 3
command.targeting.publisher_platforms[]anyOf 9stringاختياري / عنصر
  • enum: ["facebook","instagram","threads"]
command.targeting.facebook_positionsanyOf 9arrayاختياري / عنصر
  • maxItems: 4
command.targeting.facebook_positions[]anyOf 9stringاختياري / عنصر
  • enum: ["feed","story","facebook_reels","video_feeds"]
command.targeting.instagram_positionsanyOf 9arrayاختياري / عنصر
  • maxItems: 4
command.targeting.instagram_positions[]anyOf 9stringاختياري / عنصر
  • enum: ["stream","story","reels","explore"]
command.targeting.threads_positionsanyOf 9arrayاختياري / عنصر
  • maxItems: 1
command.targeting.threads_positions[]anyOf 9stringاختياري / عنصر
  • enum: ["threads_stream"]
command.targeting.custom_audience_idsanyOf 9arrayاختياري / عنصر
  • maxItems: 4
command.targeting.custom_audience_ids[]anyOf 9stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
command.targeting.excluded_custom_audience_idsanyOf 9arrayاختياري / عنصر
  • maxItems: 4
command.targeting.excluded_custom_audience_ids[]anyOf 9stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "advertising_account_id": {
      "type": "string",
      "format": "uuid"
    },
    "mutation_id": {
      "type": "string",
      "format": "uuid"
    },
    "command": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "create_campaign"
              ]
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "budget": {
              "$ref": "#/$defs/s2"
            },
            "objective": {
              "type": "string",
              "enum": [
                "OUTCOME_AWARENESS",
                "OUTCOME_ENGAGEMENT",
                "OUTCOME_LEADS",
                "OUTCOME_SALES",
                "OUTCOME_TRAFFIC",
                "OUTCOME_APP_PROMOTION"
              ]
            },
            "special_ad_categories": {
              "maxItems": 4,
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "CREDIT",
                  "EMPLOYMENT",
                  "HOUSING",
                  "ISSUES_ELECTIONS_POLITICS"
                ]
              }
            },
            "status": {
              "$ref": "#/$defs/s6"
            }
          },
          "required": [
            "operation",
            "name",
            "objective"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "update_campaign"
              ]
            },
            "object_id": {
              "$ref": "#/$defs/s3"
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "budget": {
              "$ref": "#/$defs/s2"
            },
            "status": {
              "$ref": "#/$defs/s5"
            }
          },
          "required": [
            "operation",
            "object_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "create_adset"
              ]
            },
            "campaign_id": {
              "$ref": "#/$defs/s3"
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "budget": {
              "$ref": "#/$defs/s2"
            },
            "targeting": {
              "$ref": "#/$defs/s0"
            },
            "billing_event": {
              "type": "string",
              "enum": [
                "IMPRESSIONS",
                "LINK_CLICKS"
              ]
            },
            "optimization_goal": {
              "type": "string",
              "enum": [
                "REACH",
                "IMPRESSIONS",
                "LINK_CLICKS",
                "LANDING_PAGE_VIEWS",
                "OFFSITE_CONVERSIONS",
                "LEAD_GENERATION"
              ]
            },
            "bid_strategy": {
              "type": "string",
              "enum": [
                "LOWEST_COST_WITHOUT_CAP"
              ]
            },
            "start_time": {
              "$ref": "#/$defs/s1"
            },
            "end_time": {
              "$ref": "#/$defs/s1"
            },
            "promoted_object": {
              "type": "object",
              "properties": {
                "page_id": {
                  "$ref": "#/$defs/s3"
                },
                "pixel_id": {
                  "$ref": "#/$defs/s3"
                },
                "custom_event_type": {
                  "type": "string",
                  "enum": [
                    "PURCHASE",
                    "LEAD",
                    "COMPLETE_REGISTRATION",
                    "ADD_TO_CART"
                  ]
                }
              },
              "additionalProperties": false
            },
            "status": {
              "$ref": "#/$defs/s6"
            }
          },
          "required": [
            "operation",
            "campaign_id",
            "name",
            "targeting",
            "billing_event",
            "optimization_goal"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "update_adset"
              ]
            },
            "object_id": {
              "$ref": "#/$defs/s3"
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "budget": {
              "$ref": "#/$defs/s2"
            },
            "status": {
              "$ref": "#/$defs/s5"
            },
            "targeting": {
              "$ref": "#/$defs/s0"
            },
            "start_time": {
              "$ref": "#/$defs/s1"
            },
            "end_time": {
              "$ref": "#/$defs/s1"
            }
          },
          "required": [
            "operation",
            "object_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "create_ad"
              ]
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "adset_id": {
              "$ref": "#/$defs/s3"
            },
            "creative_id": {
              "$ref": "#/$defs/s3"
            },
            "status": {
              "$ref": "#/$defs/s6"
            }
          },
          "required": [
            "operation",
            "name",
            "adset_id",
            "creative_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "update_ad"
              ]
            },
            "object_id": {
              "$ref": "#/$defs/s3"
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "creative_id": {
              "$ref": "#/$defs/s3"
            },
            "status": {
              "$ref": "#/$defs/s5"
            }
          },
          "required": [
            "operation",
            "object_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "create_creative"
              ]
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "object_story_spec": {
              "type": "object",
              "properties": {
                "page_id": {
                  "$ref": "#/$defs/s3"
                },
                "instagram_user_id": {
                  "$ref": "#/$defs/s3"
                },
                "link_data": {
                  "type": "object",
                  "properties": {
                    "link": {
                      "type": "string",
                      "maxLength": 2048,
                      "format": "uri"
                    },
                    "message": {
                      "type": "string",
                      "maxLength": 5000
                    },
                    "name": {
                      "$ref": "#/$defs/s4"
                    },
                    "image_hash": {
                      "type": "string",
                      "pattern": "^[a-fA-F0-9]{16,128}$"
                    },
                    "call_to_action": {
                      "type": "string",
                      "enum": [
                        "LEARN_MORE",
                        "SHOP_NOW",
                        "SIGN_UP",
                        "CONTACT_US"
                      ]
                    }
                  },
                  "required": [
                    "link",
                    "message",
                    "image_hash"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "page_id",
                "link_data"
              ],
              "additionalProperties": false
            },
            "object_story_id": {
              "type": "string",
              "pattern": "^[1-9]\\d{1,24}_[1-9]\\d{1,24}$"
            }
          },
          "required": [
            "operation",
            "name"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "create_saved_audience"
              ]
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "targeting": {
              "$ref": "#/$defs/s0"
            }
          },
          "required": [
            "operation",
            "name",
            "targeting"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operation": {
              "type": "string",
              "enum": [
                "update_saved_audience"
              ]
            },
            "object_id": {
              "$ref": "#/$defs/s3"
            },
            "name": {
              "$ref": "#/$defs/s4"
            },
            "targeting": {
              "$ref": "#/$defs/s0"
            }
          },
          "required": [
            "operation",
            "object_id"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": [
    "workspace_id",
    "advertising_account_id",
    "mutation_id",
    "command"
  ],
  "additionalProperties": false,
  "$defs": {
    "s0": {
      "type": "object",
      "properties": {
        "geo_locations": {
          "type": "object",
          "properties": {
            "countries": {
              "minItems": 1,
              "maxItems": 25,
              "type": "array",
              "items": {
                "type": "string",
                "pattern": "^[A-Z]{2}$"
              }
            }
          },
          "required": [
            "countries"
          ],
          "additionalProperties": false
        },
        "age_min": {
          "type": "integer",
          "minimum": 18,
          "maximum": 65
        },
        "age_max": {
          "type": "integer",
          "minimum": 18,
          "maximum": 65
        },
        "genders": {
          "minItems": 1,
          "maxItems": 2,
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "number",
                "enum": [
                  1
                ]
              },
              {
                "type": "number",
                "enum": [
                  2
                ]
              }
            ]
          }
        },
        "locales": {
          "maxItems": 25,
          "type": "array",
          "items": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          }
        },
        "publisher_platforms": {
          "minItems": 1,
          "maxItems": 3,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "facebook",
              "instagram",
              "threads"
            ]
          }
        },
        "facebook_positions": {
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "feed",
              "story",
              "facebook_reels",
              "video_feeds"
            ]
          }
        },
        "instagram_positions": {
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "stream",
              "story",
              "reels",
              "explore"
            ]
          }
        },
        "threads_positions": {
          "maxItems": 1,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "threads_stream"
            ]
          }
        },
        "custom_audience_ids": {
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[1-9]\\d{1,24}$"
          }
        },
        "excluded_custom_audience_ids": {
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[1-9]\\d{1,24}$"
          }
        }
      },
      "required": [
        "geo_locations",
        "publisher_platforms"
      ],
      "additionalProperties": false
    },
    "s1": {
      "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)))$"
    },
    "s2": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "daily",
            "lifetime"
          ]
        },
        "amount_minor": {
          "type": "string",
          "pattern": "^[1-9]\\d{0,11}$"
        }
      },
      "required": [
        "kind",
        "amount_minor"
      ],
      "additionalProperties": false
    },
    "s3": {
      "type": "string",
      "pattern": "^[1-9]\\d{1,24}$"
    },
    "s4": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "s5": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "PAUSED",
        "ARCHIVED"
      ]
    },
    "s6": {
      "type": "string",
      "enum": [
        "PAUSED"
      ]
    }
  }
}

مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

مخرجات منظّمة
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
contract_versionstringمطلوب في العنصر الأب
  • const: "advertising/v1"
prepare_tokenstringمطلوب في العنصر الأب
  • minLength: 32
  • maxLength: 128
expires_atstringمطلوب في العنصر الأب
  • 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)))$"
actionobjectمطلوب في العنصر الأب
  • additionalProperties: false
action.idstringمطلوب في العنصر الأب
  • format: "uuid"
action.workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
action.advertising_account_idstringمطلوب في العنصر الأب
  • format: "uuid"
action.mutation_idstringمطلوب في العنصر الأب
  • format: "uuid"
action.statusstringمطلوب في العنصر الأب
  • enum: ["prepared","queued","processing","succeeded","failed","unknown","cancelled"]
action.commandobjectمطلوب في العنصر الأب—
action.commandoneOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 1stringمطلوب في العنصر الأب
  • const: "create_campaign"
action.command.nameoneOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
action.command.budgetoneOf 1objectاختياري / عنصر
  • additionalProperties: false
action.command.budget.kindoneOf 1stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
action.command.budget.amount_minoroneOf 1stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
action.command.objectiveoneOf 1stringمطلوب في العنصر الأب
  • enum: ["OUTCOME_AWARENESS","OUTCOME_ENGAGEMENT","OUTCOME_LEADS","OUTCOME_SALES","OUTCOME_TRAFFIC","OUTCOME_APP_PROMOTION"]
action.command.special_ad_categoriesoneOf 1arrayمطلوب في العنصر الأب
  • maxItems: 4
  • default: []
action.command.special_ad_categories[]oneOf 1stringاختياري / عنصر
  • enum: ["CREDIT","EMPLOYMENT","HOUSING","ISSUES_ELECTIONS_POLITICS"]
action.command.statusoneOf 1stringمطلوب في العنصر الأب
  • const: "PAUSED"
  • default: "PAUSED"
action.commandoneOf 2objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 2stringمطلوب في العنصر الأب
  • const: "update_campaign"
action.command.object_idoneOf 2stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.command.nameoneOf 2stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
action.command.budgetoneOf 2objectاختياري / عنصر
  • additionalProperties: false
action.command.budget.kindoneOf 2stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
action.command.budget.amount_minoroneOf 2stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
action.command.statusoneOf 2stringاختياري / عنصر
  • enum: ["ACTIVE","PAUSED","ARCHIVED"]
action.commandoneOf 3objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 3stringمطلوب في العنصر الأب
  • const: "create_adset"
action.command.campaign_idoneOf 3stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.command.nameoneOf 3stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
action.command.budgetoneOf 3objectاختياري / عنصر
  • additionalProperties: false
action.command.budget.kindoneOf 3stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
action.command.budget.amount_minoroneOf 3stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
action.command.targetingoneOf 3objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.targeting.geo_locationsoneOf 3objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.targeting.geo_locations.countriesoneOf 3arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 25
action.command.targeting.geo_locations.countries[]oneOf 3stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
action.command.targeting.age_minoneOf 3integerمطلوب في العنصر الأب
  • minimum: 18
  • maximum: 65
  • default: 18
action.command.targeting.age_maxoneOf 3integerمطلوب في العنصر الأب
  • minimum: 18
  • maximum: 65
  • default: 65
action.command.targeting.gendersoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
action.command.targeting.genders[]oneOf 3numberاختياري / عنصر—
action.command.targeting.genders[]oneOf 3 / anyOf 1numberاختياري / عنصر
  • const: 1
action.command.targeting.genders[]oneOf 3 / anyOf 2numberاختياري / عنصر
  • const: 2
action.command.targeting.localesoneOf 3arrayاختياري / عنصر
  • maxItems: 25
action.command.targeting.locales[]oneOf 3integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
action.command.targeting.publisher_platformsoneOf 3arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 3
action.command.targeting.publisher_platforms[]oneOf 3stringاختياري / عنصر
  • enum: ["facebook","instagram","threads"]
action.command.targeting.facebook_positionsoneOf 3arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.facebook_positions[]oneOf 3stringاختياري / عنصر
  • enum: ["feed","story","facebook_reels","video_feeds"]
action.command.targeting.instagram_positionsoneOf 3arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.instagram_positions[]oneOf 3stringاختياري / عنصر
  • enum: ["stream","story","reels","explore"]
action.command.targeting.threads_positionsoneOf 3arrayاختياري / عنصر
  • maxItems: 1
action.command.targeting.threads_positions[]oneOf 3stringاختياري / عنصر
  • const: "threads_stream"
action.command.targeting.custom_audience_idsoneOf 3arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.custom_audience_ids[]oneOf 3stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.targeting.excluded_custom_audience_idsoneOf 3arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.excluded_custom_audience_ids[]oneOf 3stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.billing_eventoneOf 3stringمطلوب في العنصر الأب
  • enum: ["IMPRESSIONS","LINK_CLICKS"]
action.command.optimization_goaloneOf 3stringمطلوب في العنصر الأب
  • enum: ["REACH","IMPRESSIONS","LINK_CLICKS","LANDING_PAGE_VIEWS","OFFSITE_CONVERSIONS","LEAD_GENERATION"]
action.command.bid_strategyoneOf 3stringمطلوب في العنصر الأب
  • const: "LOWEST_COST_WITHOUT_CAP"
  • default: "LOWEST_COST_WITHOUT_CAP"
action.command.start_timeoneOf 3stringاختياري / عنصر
  • 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)))$"
action.command.end_timeoneOf 3stringاختياري / عنصر
  • 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)))$"
action.command.promoted_objectoneOf 3objectاختياري / عنصر
  • additionalProperties: false
action.command.promoted_object.page_idoneOf 3stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.promoted_object.pixel_idoneOf 3stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.promoted_object.custom_event_typeoneOf 3stringاختياري / عنصر
  • enum: ["PURCHASE","LEAD","COMPLETE_REGISTRATION","ADD_TO_CART"]
action.command.statusoneOf 3stringمطلوب في العنصر الأب
  • const: "PAUSED"
  • default: "PAUSED"
action.commandoneOf 4objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 4stringمطلوب في العنصر الأب
  • const: "update_adset"
action.command.object_idoneOf 4stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.command.nameoneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
action.command.budgetoneOf 4objectاختياري / عنصر
  • additionalProperties: false
action.command.budget.kindoneOf 4stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
action.command.budget.amount_minoroneOf 4stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
action.command.statusoneOf 4stringاختياري / عنصر
  • enum: ["ACTIVE","PAUSED","ARCHIVED"]
action.command.targetingoneOf 4objectاختياري / عنصر
  • additionalProperties: false
action.command.targeting.geo_locationsoneOf 4objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.targeting.geo_locations.countriesoneOf 4arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 25
action.command.targeting.geo_locations.countries[]oneOf 4stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
action.command.targeting.age_minoneOf 4integerمطلوب في العنصر الأب
  • minimum: 18
  • maximum: 65
  • default: 18
action.command.targeting.age_maxoneOf 4integerمطلوب في العنصر الأب
  • minimum: 18
  • maximum: 65
  • default: 65
action.command.targeting.gendersoneOf 4arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
action.command.targeting.genders[]oneOf 4numberاختياري / عنصر—
action.command.targeting.genders[]oneOf 4 / anyOf 1numberاختياري / عنصر
  • const: 1
action.command.targeting.genders[]oneOf 4 / anyOf 2numberاختياري / عنصر
  • const: 2
action.command.targeting.localesoneOf 4arrayاختياري / عنصر
  • maxItems: 25
action.command.targeting.locales[]oneOf 4integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
action.command.targeting.publisher_platformsoneOf 4arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 3
action.command.targeting.publisher_platforms[]oneOf 4stringاختياري / عنصر
  • enum: ["facebook","instagram","threads"]
action.command.targeting.facebook_positionsoneOf 4arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.facebook_positions[]oneOf 4stringاختياري / عنصر
  • enum: ["feed","story","facebook_reels","video_feeds"]
action.command.targeting.instagram_positionsoneOf 4arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.instagram_positions[]oneOf 4stringاختياري / عنصر
  • enum: ["stream","story","reels","explore"]
action.command.targeting.threads_positionsoneOf 4arrayاختياري / عنصر
  • maxItems: 1
action.command.targeting.threads_positions[]oneOf 4stringاختياري / عنصر
  • const: "threads_stream"
action.command.targeting.custom_audience_idsoneOf 4arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.custom_audience_ids[]oneOf 4stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.targeting.excluded_custom_audience_idsoneOf 4arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.excluded_custom_audience_ids[]oneOf 4stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.start_timeoneOf 4stringاختياري / عنصر
  • 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)))$"
action.command.end_timeoneOf 4stringاختياري / عنصر
  • 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)))$"
action.commandoneOf 5objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 5stringمطلوب في العنصر الأب
  • const: "create_ad"
action.command.nameoneOf 5stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
action.command.adset_idoneOf 5stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.command.creative_idoneOf 5stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.command.statusoneOf 5stringمطلوب في العنصر الأب
  • const: "PAUSED"
  • default: "PAUSED"
action.commandoneOf 6objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 6stringمطلوب في العنصر الأب
  • const: "update_ad"
action.command.object_idoneOf 6stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.command.nameoneOf 6stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
action.command.creative_idoneOf 6stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.statusoneOf 6stringاختياري / عنصر
  • enum: ["ACTIVE","PAUSED","ARCHIVED"]
action.commandoneOf 7objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 7stringمطلوب في العنصر الأب
  • const: "create_creative"
action.command.nameoneOf 7stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
action.command.object_story_speconeOf 7objectاختياري / عنصر
  • additionalProperties: false
action.command.object_story_spec.page_idoneOf 7stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.command.object_story_spec.instagram_user_idoneOf 7stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.object_story_spec.link_dataoneOf 7objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.object_story_spec.link_data.linkoneOf 7stringمطلوب في العنصر الأب
  • format: "uri"
  • maxLength: 2048
action.command.object_story_spec.link_data.messageoneOf 7stringمطلوب في العنصر الأب
  • maxLength: 5000
action.command.object_story_spec.link_data.nameoneOf 7stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
action.command.object_story_spec.link_data.image_hashoneOf 7stringمطلوب في العنصر الأب
  • pattern: "^[a-fA-F0-9]{16,128}$"
action.command.object_story_spec.link_data.call_to_actiononeOf 7stringاختياري / عنصر
  • enum: ["LEARN_MORE","SHOP_NOW","SIGN_UP","CONTACT_US"]
action.command.object_story_idoneOf 7stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}_[1-9]\\d{1,24}$"
action.commandoneOf 8objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 8stringمطلوب في العنصر الأب
  • const: "create_saved_audience"
action.command.nameoneOf 8stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
action.command.targetingoneOf 8objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.targeting.geo_locationsoneOf 8objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.targeting.geo_locations.countriesoneOf 8arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 25
action.command.targeting.geo_locations.countries[]oneOf 8stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
action.command.targeting.age_minoneOf 8integerمطلوب في العنصر الأب
  • minimum: 18
  • maximum: 65
  • default: 18
action.command.targeting.age_maxoneOf 8integerمطلوب في العنصر الأب
  • minimum: 18
  • maximum: 65
  • default: 65
action.command.targeting.gendersoneOf 8arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
action.command.targeting.genders[]oneOf 8numberاختياري / عنصر—
action.command.targeting.genders[]oneOf 8 / anyOf 1numberاختياري / عنصر
  • const: 1
action.command.targeting.genders[]oneOf 8 / anyOf 2numberاختياري / عنصر
  • const: 2
action.command.targeting.localesoneOf 8arrayاختياري / عنصر
  • maxItems: 25
action.command.targeting.locales[]oneOf 8integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
action.command.targeting.publisher_platformsoneOf 8arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 3
action.command.targeting.publisher_platforms[]oneOf 8stringاختياري / عنصر
  • enum: ["facebook","instagram","threads"]
action.command.targeting.facebook_positionsoneOf 8arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.facebook_positions[]oneOf 8stringاختياري / عنصر
  • enum: ["feed","story","facebook_reels","video_feeds"]
action.command.targeting.instagram_positionsoneOf 8arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.instagram_positions[]oneOf 8stringاختياري / عنصر
  • enum: ["stream","story","reels","explore"]
action.command.targeting.threads_positionsoneOf 8arrayاختياري / عنصر
  • maxItems: 1
action.command.targeting.threads_positions[]oneOf 8stringاختياري / عنصر
  • const: "threads_stream"
action.command.targeting.custom_audience_idsoneOf 8arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.custom_audience_ids[]oneOf 8stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.targeting.excluded_custom_audience_idsoneOf 8arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.excluded_custom_audience_ids[]oneOf 8stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.commandoneOf 9objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.operationoneOf 9stringمطلوب في العنصر الأب
  • const: "update_saved_audience"
action.command.object_idoneOf 9stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.command.nameoneOf 9stringاختياري / عنصر
  • minLength: 1
  • maxLength: 200
action.command.targetingoneOf 9objectاختياري / عنصر
  • additionalProperties: false
action.command.targeting.geo_locationsoneOf 9objectمطلوب في العنصر الأب
  • additionalProperties: false
action.command.targeting.geo_locations.countriesoneOf 9arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 25
action.command.targeting.geo_locations.countries[]oneOf 9stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
action.command.targeting.age_minoneOf 9integerمطلوب في العنصر الأب
  • minimum: 18
  • maximum: 65
  • default: 18
action.command.targeting.age_maxoneOf 9integerمطلوب في العنصر الأب
  • minimum: 18
  • maximum: 65
  • default: 65
action.command.targeting.gendersoneOf 9arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
action.command.targeting.genders[]oneOf 9numberاختياري / عنصر—
action.command.targeting.genders[]oneOf 9 / anyOf 1numberاختياري / عنصر
  • const: 1
action.command.targeting.genders[]oneOf 9 / anyOf 2numberاختياري / عنصر
  • const: 2
action.command.targeting.localesoneOf 9arrayاختياري / عنصر
  • maxItems: 25
action.command.targeting.locales[]oneOf 9integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
action.command.targeting.publisher_platformsoneOf 9arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 3
action.command.targeting.publisher_platforms[]oneOf 9stringاختياري / عنصر
  • enum: ["facebook","instagram","threads"]
action.command.targeting.facebook_positionsoneOf 9arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.facebook_positions[]oneOf 9stringاختياري / عنصر
  • enum: ["feed","story","facebook_reels","video_feeds"]
action.command.targeting.instagram_positionsoneOf 9arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.instagram_positions[]oneOf 9stringاختياري / عنصر
  • enum: ["stream","story","reels","explore"]
action.command.targeting.threads_positionsoneOf 9arrayاختياري / عنصر
  • maxItems: 1
action.command.targeting.threads_positions[]oneOf 9stringاختياري / عنصر
  • const: "threads_stream"
action.command.targeting.custom_audience_idsoneOf 9arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.custom_audience_ids[]oneOf 9stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.command.targeting.excluded_custom_audience_idsoneOf 9arrayاختياري / عنصر
  • maxItems: 4
action.command.targeting.excluded_custom_audience_ids[]oneOf 9stringاختياري / عنصر
  • pattern: "^[1-9]\\d{1,24}$"
action.reviewed_digeststringمطلوب في العنصر الأب
  • pattern: "^[a-f0-9]{64}$"
action.effectsobjectمطلوب في العنصر الأب
  • additionalProperties: false
action.effects.creates_objectbooleanمطلوب في العنصر الأب—
action.effects.initial_statusstring | nullمطلوب في العنصر الأب—
action.effects.initial_statusanyOf 1stringمطلوب في العنصر الأب
  • const: "PAUSED"
action.effects.initial_statusanyOf 2nullمطلوب في العنصر الأب—
action.effects.activates_deliverybooleanمطلوب في العنصر الأب—
action.effects.changes_budgetbooleanمطلوب في العنصر الأب—
action.effects.changes_audiencebooleanمطلوب في العنصر الأب—
action.effects.changes_creativebooleanمطلوب في العنصر الأب—
action.effects.currencystringمطلوب في العنصر الأب
  • pattern: "^[A-Z]{3}$"
action.effects.timezonestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 100
action.effects.budgetobject | nullمطلوب في العنصر الأب—
action.effects.budgetanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
action.effects.budget.kindanyOf 1stringمطلوب في العنصر الأب
  • enum: ["daily","lifetime"]
action.effects.budget.amount_minoranyOf 1stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{0,11}$"
action.effects.budgetanyOf 2nullمطلوب في العنصر الأب—
action.live_approvalobjectمطلوب في العنصر الأب
  • additionalProperties: false
action.live_approval.requiredbooleanمطلوب في العنصر الأب—
action.live_approval.statestringمطلوب في العنصر الأب
  • enum: ["not_required","missing","approved","expired","revoked","invalid"]
action.live_approval.reasonstring | nullمطلوب في العنصر الأب—
action.live_approval.reasonanyOf 1stringمطلوب في العنصر الأب
  • maxLength: 100
action.live_approval.reasonanyOf 2nullمطلوب في العنصر الأب—
action.live_approval.expires_atstring | nullمطلوب في العنصر الأب—
action.live_approval.expires_atanyOf 1stringمطلوب في العنصر الأب
  • 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)))$"
action.live_approval.expires_atanyOf 2nullمطلوب في العنصر الأب—
action.live_approval.approved_bystring | nullمطلوب في العنصر الأب—
action.live_approval.approved_byanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
action.live_approval.approved_byanyOf 2nullمطلوب في العنصر الأب—
action.provider_object_idstring | nullمطلوب في العنصر الأب—
action.provider_object_idanyOf 1stringمطلوب في العنصر الأب
  • pattern: "^[1-9]\\d{1,24}$"
action.provider_object_idanyOf 2nullمطلوب في العنصر الأب—
action.failure_codestring | nullمطلوب في العنصر الأب—
action.failure_codeanyOf 1stringمطلوب في العنصر الأب
  • maxLength: 100
action.failure_codeanyOf 2nullمطلوب في العنصر الأب—
action.created_atstringمطلوب في العنصر الأب
  • 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)))$"
action.completed_atstring | nullمطلوب في العنصر الأب—
action.completed_atanyOf 1stringمطلوب في العنصر الأب
  • 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)))$"
action.completed_atanyOf 2nullمطلوب في العنصر الأب—
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "advertising/v1"
    },
    "prepare_token": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128
    },
    "expires_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)))$"
    },
    "action": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "advertising_account_id": {
          "type": "string",
          "format": "uuid"
        },
        "mutation_id": {
          "type": "string",
          "format": "uuid"
        },
        "status": {
          "type": "string",
          "enum": [
            "prepared",
            "queued",
            "processing",
            "succeeded",
            "failed",
            "unknown",
            "cancelled"
          ]
        },
        "command": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "create_campaign"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "budget": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "daily",
                        "lifetime"
                      ]
                    },
                    "amount_minor": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{0,11}$"
                    }
                  },
                  "required": [
                    "kind",
                    "amount_minor"
                  ],
                  "additionalProperties": false
                },
                "objective": {
                  "type": "string",
                  "enum": [
                    "OUTCOME_AWARENESS",
                    "OUTCOME_ENGAGEMENT",
                    "OUTCOME_LEADS",
                    "OUTCOME_SALES",
                    "OUTCOME_TRAFFIC",
                    "OUTCOME_APP_PROMOTION"
                  ]
                },
                "special_ad_categories": {
                  "default": [],
                  "maxItems": 4,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "enum": [
                      "CREDIT",
                      "EMPLOYMENT",
                      "HOUSING",
                      "ISSUES_ELECTIONS_POLITICS"
                    ]
                  }
                },
                "status": {
                  "default": "PAUSED",
                  "type": "string",
                  "const": "PAUSED"
                }
              },
              "required": [
                "operation",
                "name",
                "objective",
                "special_ad_categories",
                "status"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "update_campaign"
                },
                "object_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}$"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "budget": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "daily",
                        "lifetime"
                      ]
                    },
                    "amount_minor": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{0,11}$"
                    }
                  },
                  "required": [
                    "kind",
                    "amount_minor"
                  ],
                  "additionalProperties": false
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "ACTIVE",
                    "PAUSED",
                    "ARCHIVED"
                  ]
                }
              },
              "required": [
                "operation",
                "object_id"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "create_adset"
                },
                "campaign_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}$"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "budget": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "daily",
                        "lifetime"
                      ]
                    },
                    "amount_minor": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{0,11}$"
                    }
                  },
                  "required": [
                    "kind",
                    "amount_minor"
                  ],
                  "additionalProperties": false
                },
                "targeting": {
                  "type": "object",
                  "properties": {
                    "geo_locations": {
                      "type": "object",
                      "properties": {
                        "countries": {
                          "minItems": 1,
                          "maxItems": 25,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z]{2}$"
                          }
                        }
                      },
                      "required": [
                        "countries"
                      ],
                      "additionalProperties": false
                    },
                    "age_min": {
                      "default": 18,
                      "type": "integer",
                      "minimum": 18,
                      "maximum": 65
                    },
                    "age_max": {
                      "default": 65,
                      "type": "integer",
                      "minimum": 18,
                      "maximum": 65
                    },
                    "genders": {
                      "minItems": 1,
                      "maxItems": 2,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "number",
                            "const": 1
                          },
                          {
                            "type": "number",
                            "const": 2
                          }
                        ]
                      }
                    },
                    "locales": {
                      "maxItems": 25,
                      "type": "array",
                      "items": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "publisher_platforms": {
                      "minItems": 1,
                      "maxItems": 3,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "facebook",
                          "instagram",
                          "threads"
                        ]
                      }
                    },
                    "facebook_positions": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "feed",
                          "story",
                          "facebook_reels",
                          "video_feeds"
                        ]
                      }
                    },
                    "instagram_positions": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "stream",
                          "story",
                          "reels",
                          "explore"
                        ]
                      }
                    },
                    "threads_positions": {
                      "maxItems": 1,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "const": "threads_stream"
                      }
                    },
                    "custom_audience_ids": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[1-9]\\d{1,24}$"
                      }
                    },
                    "excluded_custom_audience_ids": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[1-9]\\d{1,24}$"
                      }
                    }
                  },
                  "required": [
                    "geo_locations",
                    "age_min",
                    "age_max",
                    "publisher_platforms"
                  ],
                  "additionalProperties": false
                },
                "billing_event": {
                  "type": "string",
                  "enum": [
                    "IMPRESSIONS",
                    "LINK_CLICKS"
                  ]
                },
                "optimization_goal": {
                  "type": "string",
                  "enum": [
                    "REACH",
                    "IMPRESSIONS",
                    "LINK_CLICKS",
                    "LANDING_PAGE_VIEWS",
                    "OFFSITE_CONVERSIONS",
                    "LEAD_GENERATION"
                  ]
                },
                "bid_strategy": {
                  "default": "LOWEST_COST_WITHOUT_CAP",
                  "type": "string",
                  "const": "LOWEST_COST_WITHOUT_CAP"
                },
                "start_time": {
                  "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)))$"
                },
                "end_time": {
                  "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)))$"
                },
                "promoted_object": {
                  "type": "object",
                  "properties": {
                    "page_id": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{1,24}$"
                    },
                    "pixel_id": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{1,24}$"
                    },
                    "custom_event_type": {
                      "type": "string",
                      "enum": [
                        "PURCHASE",
                        "LEAD",
                        "COMPLETE_REGISTRATION",
                        "ADD_TO_CART"
                      ]
                    }
                  },
                  "additionalProperties": false
                },
                "status": {
                  "default": "PAUSED",
                  "type": "string",
                  "const": "PAUSED"
                }
              },
              "required": [
                "operation",
                "campaign_id",
                "name",
                "targeting",
                "billing_event",
                "optimization_goal",
                "bid_strategy",
                "status"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "update_adset"
                },
                "object_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}$"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "budget": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "daily",
                        "lifetime"
                      ]
                    },
                    "amount_minor": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{0,11}$"
                    }
                  },
                  "required": [
                    "kind",
                    "amount_minor"
                  ],
                  "additionalProperties": false
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "ACTIVE",
                    "PAUSED",
                    "ARCHIVED"
                  ]
                },
                "targeting": {
                  "type": "object",
                  "properties": {
                    "geo_locations": {
                      "type": "object",
                      "properties": {
                        "countries": {
                          "minItems": 1,
                          "maxItems": 25,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z]{2}$"
                          }
                        }
                      },
                      "required": [
                        "countries"
                      ],
                      "additionalProperties": false
                    },
                    "age_min": {
                      "default": 18,
                      "type": "integer",
                      "minimum": 18,
                      "maximum": 65
                    },
                    "age_max": {
                      "default": 65,
                      "type": "integer",
                      "minimum": 18,
                      "maximum": 65
                    },
                    "genders": {
                      "minItems": 1,
                      "maxItems": 2,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "number",
                            "const": 1
                          },
                          {
                            "type": "number",
                            "const": 2
                          }
                        ]
                      }
                    },
                    "locales": {
                      "maxItems": 25,
                      "type": "array",
                      "items": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "publisher_platforms": {
                      "minItems": 1,
                      "maxItems": 3,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "facebook",
                          "instagram",
                          "threads"
                        ]
                      }
                    },
                    "facebook_positions": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "feed",
                          "story",
                          "facebook_reels",
                          "video_feeds"
                        ]
                      }
                    },
                    "instagram_positions": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "stream",
                          "story",
                          "reels",
                          "explore"
                        ]
                      }
                    },
                    "threads_positions": {
                      "maxItems": 1,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "const": "threads_stream"
                      }
                    },
                    "custom_audience_ids": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[1-9]\\d{1,24}$"
                      }
                    },
                    "excluded_custom_audience_ids": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[1-9]\\d{1,24}$"
                      }
                    }
                  },
                  "required": [
                    "geo_locations",
                    "age_min",
                    "age_max",
                    "publisher_platforms"
                  ],
                  "additionalProperties": false
                },
                "start_time": {
                  "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)))$"
                },
                "end_time": {
                  "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)))$"
                }
              },
              "required": [
                "operation",
                "object_id"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "create_ad"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "adset_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}$"
                },
                "creative_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}$"
                },
                "status": {
                  "default": "PAUSED",
                  "type": "string",
                  "const": "PAUSED"
                }
              },
              "required": [
                "operation",
                "name",
                "adset_id",
                "creative_id",
                "status"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "update_ad"
                },
                "object_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}$"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "creative_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}$"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "ACTIVE",
                    "PAUSED",
                    "ARCHIVED"
                  ]
                }
              },
              "required": [
                "operation",
                "object_id"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "create_creative"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "object_story_spec": {
                  "type": "object",
                  "properties": {
                    "page_id": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{1,24}$"
                    },
                    "instagram_user_id": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{1,24}$"
                    },
                    "link_data": {
                      "type": "object",
                      "properties": {
                        "link": {
                          "type": "string",
                          "maxLength": 2048,
                          "format": "uri"
                        },
                        "message": {
                          "type": "string",
                          "maxLength": 5000
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "image_hash": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{16,128}$"
                        },
                        "call_to_action": {
                          "type": "string",
                          "enum": [
                            "LEARN_MORE",
                            "SHOP_NOW",
                            "SIGN_UP",
                            "CONTACT_US"
                          ]
                        }
                      },
                      "required": [
                        "link",
                        "message",
                        "image_hash"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "page_id",
                    "link_data"
                  ],
                  "additionalProperties": false
                },
                "object_story_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}_[1-9]\\d{1,24}$"
                }
              },
              "required": [
                "operation",
                "name"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "create_saved_audience"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "targeting": {
                  "type": "object",
                  "properties": {
                    "geo_locations": {
                      "type": "object",
                      "properties": {
                        "countries": {
                          "minItems": 1,
                          "maxItems": 25,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z]{2}$"
                          }
                        }
                      },
                      "required": [
                        "countries"
                      ],
                      "additionalProperties": false
                    },
                    "age_min": {
                      "default": 18,
                      "type": "integer",
                      "minimum": 18,
                      "maximum": 65
                    },
                    "age_max": {
                      "default": 65,
                      "type": "integer",
                      "minimum": 18,
                      "maximum": 65
                    },
                    "genders": {
                      "minItems": 1,
                      "maxItems": 2,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "number",
                            "const": 1
                          },
                          {
                            "type": "number",
                            "const": 2
                          }
                        ]
                      }
                    },
                    "locales": {
                      "maxItems": 25,
                      "type": "array",
                      "items": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "publisher_platforms": {
                      "minItems": 1,
                      "maxItems": 3,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "facebook",
                          "instagram",
                          "threads"
                        ]
                      }
                    },
                    "facebook_positions": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "feed",
                          "story",
                          "facebook_reels",
                          "video_feeds"
                        ]
                      }
                    },
                    "instagram_positions": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "stream",
                          "story",
                          "reels",
                          "explore"
                        ]
                      }
                    },
                    "threads_positions": {
                      "maxItems": 1,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "const": "threads_stream"
                      }
                    },
                    "custom_audience_ids": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[1-9]\\d{1,24}$"
                      }
                    },
                    "excluded_custom_audience_ids": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[1-9]\\d{1,24}$"
                      }
                    }
                  },
                  "required": [
                    "geo_locations",
                    "age_min",
                    "age_max",
                    "publisher_platforms"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "operation",
                "name",
                "targeting"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "operation": {
                  "type": "string",
                  "const": "update_saved_audience"
                },
                "object_id": {
                  "type": "string",
                  "pattern": "^[1-9]\\d{1,24}$"
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "targeting": {
                  "type": "object",
                  "properties": {
                    "geo_locations": {
                      "type": "object",
                      "properties": {
                        "countries": {
                          "minItems": 1,
                          "maxItems": 25,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z]{2}$"
                          }
                        }
                      },
                      "required": [
                        "countries"
                      ],
                      "additionalProperties": false
                    },
                    "age_min": {
                      "default": 18,
                      "type": "integer",
                      "minimum": 18,
                      "maximum": 65
                    },
                    "age_max": {
                      "default": 65,
                      "type": "integer",
                      "minimum": 18,
                      "maximum": 65
                    },
                    "genders": {
                      "minItems": 1,
                      "maxItems": 2,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "number",
                            "const": 1
                          },
                          {
                            "type": "number",
                            "const": 2
                          }
                        ]
                      }
                    },
                    "locales": {
                      "maxItems": 25,
                      "type": "array",
                      "items": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "publisher_platforms": {
                      "minItems": 1,
                      "maxItems": 3,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "facebook",
                          "instagram",
                          "threads"
                        ]
                      }
                    },
                    "facebook_positions": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "feed",
                          "story",
                          "facebook_reels",
                          "video_feeds"
                        ]
                      }
                    },
                    "instagram_positions": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "stream",
                          "story",
                          "reels",
                          "explore"
                        ]
                      }
                    },
                    "threads_positions": {
                      "maxItems": 1,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "const": "threads_stream"
                      }
                    },
                    "custom_audience_ids": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[1-9]\\d{1,24}$"
                      }
                    },
                    "excluded_custom_audience_ids": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[1-9]\\d{1,24}$"
                      }
                    }
                  },
                  "required": [
                    "geo_locations",
                    "age_min",
                    "age_max",
                    "publisher_platforms"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "operation",
                "object_id"
              ],
              "additionalProperties": false
            }
          ]
        },
        "reviewed_digest": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "effects": {
          "type": "object",
          "properties": {
            "creates_object": {
              "type": "boolean"
            },
            "initial_status": {
              "anyOf": [
                {
                  "type": "string",
                  "const": "PAUSED"
                },
                {
                  "type": "null"
                }
              ]
            },
            "activates_delivery": {
              "type": "boolean"
            },
            "changes_budget": {
              "type": "boolean"
            },
            "changes_audience": {
              "type": "boolean"
            },
            "changes_creative": {
              "type": "boolean"
            },
            "currency": {
              "type": "string",
              "pattern": "^[A-Z]{3}$"
            },
            "timezone": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "budget": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "daily",
                        "lifetime"
                      ]
                    },
                    "amount_minor": {
                      "type": "string",
                      "pattern": "^[1-9]\\d{0,11}$"
                    }
                  },
                  "required": [
                    "kind",
                    "amount_minor"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "creates_object",
            "initial_status",
            "activates_delivery",
            "changes_budget",
            "changes_audience",
            "changes_creative",
            "currency",
            "timezone",
            "budget"
          ],
          "additionalProperties": false
        },
        "live_approval": {
          "type": "object",
          "properties": {
            "required": {
              "type": "boolean"
            },
            "state": {
              "type": "string",
              "enum": [
                "not_required",
                "missing",
                "approved",
                "expired",
                "revoked",
                "invalid"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 100
                },
                {
                  "type": "null"
                }
              ]
            },
            "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"
                }
              ]
            },
            "approved_by": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "required",
            "state",
            "reason",
            "expires_at",
            "approved_by"
          ],
          "additionalProperties": false
        },
        "provider_object_id": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[1-9]\\d{1,24}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "failure_code": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "created_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)))$"
        },
        "completed_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"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "advertising_account_id",
        "mutation_id",
        "status",
        "command",
        "reviewed_digest",
        "effects",
        "live_approval",
        "provider_object_id",
        "failure_code",
        "created_at",
        "completed_at"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "contract_version",
    "prepare_token",
    "expires_at",
    "action"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

{
  "name": "sosoapi_ads_actions_prepare",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "advertising_account_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "11111111-1111-4111-8111-111111111111",
    "command": {
      "operation": "create_campaign",
      "name": "example",
      "objective": "OUTCOME_AWARENESS"
    }
  }
}

structuredContent

{
  "contract_version": "advertising/v1",
  "prepare_token": "exampleaaaaaaaaaaaaaaaaaaaaaaaaa",
  "expires_at": "2099-01-15T09:00:00Z",
  "action": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "advertising_account_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "11111111-1111-4111-8111-111111111111",
    "status": "prepared",
    "command": {
      "operation": "create_campaign",
      "name": "example",
      "objective": "OUTCOME_AWARENESS",
      "special_ad_categories": [],
      "status": "PAUSED"
    },
    "reviewed_digest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "effects": {
      "creates_object": false,
      "initial_status": null,
      "activates_delivery": false,
      "changes_budget": false,
      "changes_audience": false,
      "changes_creative": false,
      "currency": "USD",
      "timezone": "UTC",
      "budget": null
    },
    "live_approval": {
      "required": false,
      "state": "not_required",
      "reason": null,
      "expires_at": null,
      "approved_by": null
    },
    "provider_object_id": null,
    "failure_code": null,
    "created_at": "2099-01-15T09:00:00Z",
    "completed_at": null
  }
}
تثبيت MCP أو ربطه