
تتضمن الإصدار 26.0 من واجهة Graph API وواجهة API التسويق إمكانات جديدة وعمليات إيقاف استخدام وتغييرات عاجلة. راجع أبرز العناصر أدناه وقم بزيارة سجل تغييرات الإصدار V26.0 للحصول على القائمة الكاملة للتغييرات والتفاصيل.
advantage_audience بشكل صريح على 1 أو 0. تستمر الإعدادات الافتراضية أو المبسطة في تعيينه افتراضيًا على 1، ولا تتأثر تحديثات المجموعات الإعلانية الحالية.applink_treatment فيه إلى web_only عندما تستخدم الحملة الإعلانية موقعَي التحويل موقع الويب والتطبيق. يتم تطبيق التقييد على جميع إصدارات واجهة API التسويق اعتبارًا من 27 أكتوبر 2026.story من messenger_positions تلقائيًا عند إنشاء مجموعات إعلانية أو تحديثها. ينطبق إيقاف الاستخدام على جميع إصدارات واجهة API التسويق، بما في ذلك الاستدعاءات غير المحددة الإصدار، اعتبارًا من 27 أكتوبر 2026.daily_outcomes_curve وbudget_guardrail وestimate_dau من استدعاءات الإصدار 26.0 اعتبارًا من 29 يوليو 2026، ومن جميع الإصدارات المدعومة المتبقية اعتبارًا من 27 أكتوبر 2026. لا توجد واجهة API بديلة متوفرة.بدءًا من الإصدار 26.0 من واجهة API التسويق في 29 يوليو 2026، ستدعم الإعلانات في حالة واتساب إمكانات إضافية للهوية والاستهداف والتحسين والتصميم.
wamo_whatsapp_identity_spec بشكل صريح في تصميمات الإعلانات المخصصة للعرض في حالة واتساب. لا يتم تعيين هوية واتساب افتراضيًا لهؤلاء المتصلين.user_age_unknown، يتم تعيين الحقل افتراضيًا إلى true؛ مما يعني أن الحملة الإعلانية يمكن أن تصل إلى الأشخاص على واتساب الذين لم يتم التعرُّف على أعمارهم.راجع وثائق استهداف المواضع والاستهداف الأساسي للحصول على التفاصيل.
تتم إزالة الحقول daily_outcomes_curve وbudget_guardrail وestimate_dau من استجابة نقطة نهاية تقدير العرض؛ لأن الخدمة التي تدعم هذه القيم قد تم إيقاف استخدامها. بدءًا من واجهة Graph API الإصدار 26.0 وواجهة API التسويق الإصدار 26.0 في 29 يوليو 2026، لن يتم إرجاع هذه الحقول بعد ذلك. سيتم تطبيق التغيير على جميع الإصدارات المتبقية المدعومة لواجهة API التسويق وواجهة Graph API في 27 أكتوبر 2026. لا توجد واجهة API بديلة متوفرة.
يجب على المطوّرين إزالة أي استخدام أو مراجع لهذه الحقول قبل تاريخ الإزالة المحدد.
تتضمن نقاط النهاية المتأثرة ما يلي:
/{ad-account-id}/delivery_estimate - Ad account delivery estimates/{adset-id}/delivery_estimate - تقديرات عرض المجموعة الإعلانيةستتوفر قائمة الحقول ونقاط النهاية الكاملة في سجل تغييرات الإصدار V26.0.
سيتم حظر التطبيقات التي تستدعي نقاط النهاية هذه على الإصدار 26.0 من واجهة Graph API أو الإصدارات الأحدث اعتبارًا من 29 يوليو 2026. ستتم إزالة نقاط النهاية لجميع إصدارات واجهة Graph API المتبقية في 27 أكتوبر 2026، وستُرجع الاستدعاءات بعد ذلك الأخطاء.
تم إيقاف استخدام تجربة إتمام الشراء مباشرةً على فيسبوك وInstagram للمتاجر تمامًا. سمحت واجهة API إدارة طلبات المعاملات التجارية للمنصات التابعة لجهات خارجية بإدراج الطلبات، وعرض تفاصيل الطلب، وإدارة الشحنات، ومعالجة عمليات الإلغاء، والتعامل مع عمليات استرداد الأموال، وتتبُّع عمليات الإرجاع لتجربة إتمام الشراء هذه. نظرًا لإيقاف البنية الأساسية لطلبات المعاملات التجارية، سيتم إيقاف استخدام نقاط النهاية هذه.
يجب على المطورين إيقاف استدعاء نقاط النهاية هذه وإزالة التبعية. لا توجد واجهة API بديلة متوفرة.
تتضمن نقاط النهاية المتأثرة ما يلي:
/{commerce-order-id} - تفاصيل الطلب/{commerce-order-id}/items - عناصر سطر الطلب/{commerce-order-id}/payments - Order payments/{commerce-order-id}/payment_transaction_details - تفاصيل معاملة الدفع/{commerce-order-id}/refunds - Order refunds/{commerce-order-id}/shipments - Order shipments/{commerce-order-shipment-id}/items - عناصر سطر الشحن/{commerce-return-id} - Return details/{commerce-order-cancellation-id}/items - Cancellation line items/{page-id}/commerce_orders - عرض الطلبات حسب الصفحة/{commerce-merchant-settings-id}/commerce_orders - عرض الطلبات حسب إعدادات التجارة لدى التاجر/{commerce-merchant-settings-id}/commerce_returns - List returns by Commerce Merchant Settings/{commerce-merchant-settings-id}/tax_settings - إعدادات الضرائبستتوفر القائمة الكاملة لنقاط النهاية المتأثرة والبالغ عددها 47 نقطة في سجل تغييرات الإصدار 26.0 من واجهة Graph API.
يتم إيقاف استخدام الحقلين reference_owner وmatched_reference_owner في AudioVisualReferenceMatch وImageReferenceMatch، إلى جانب الحقلين sending_rights_holder وreceiving_rights_holder في CopyrightOwnershipTransfer. بدءًا من الإصدار 26.0 من واجهة Graph API، تتوفر الحقول البديلة التي تُرجِع نوع RightsHolderOwner المخصص لتمثيل نموذج الملكية المستخدم بواسطة مدير الحقوق بشكل أفضل، ولن يتم إرجاع الحقول التي تم إيقاف استخدامها في الاستجابات للإصدار 26.0 وما بعده.
ستستمر الحقول التي تم إيقاف استخدامها في العمل على الإصدار 25.0 والإصدارات الأقدم لمدة عامين بعد طرح الإصدار 26.0، وستتم إزالتها بعد ذلك. يجب على المطورين الترحيل إلى الحقول البديلة خلال هذه الفترة التي تمتد لمدة عامين.
استخدم الحقول البديلة التالية:
reference_owner_rh_owner بدلاً من reference_owner.matched_reference_owner_rh_owner بدلاً من matched_reference_owner.sending_rights_holder_owner بدلاً من sending_rights_holder.receiving_rights_holder_owner بدلاً من receiving_rights_holder.تتضمن نقاط النهاية المتأثرة ما يلي:
/{audio-visual-reference-match-id} - Reference match details/{image-reference-match-id} - تفاصيل مطابقة مرجع الصورة/{copyright-ownership-transfer-id} - Ownership transfer detailsستتوفر قائمة الحقول الكاملة في سجل تغييرات الإصدار 26.0 من واجهة Graph API.
اعتبارًا من 29 يوليو 2026، لن تدعم واجهة Graph API بالإصدار 26.0 والإصدارات الأحدث خمسة سلوكيات للبروتوكول القديم: pretty، وdebug، وdate_format، وطلبات GET /?ids=... الأصلية، ومعالجة If-None-Match / ETag القديمة.
يتم إيقاف هذه السلوكيات لتبسيط استجابات واجهة Graph API وجعل التعامل مع الطلبات أكثر اتساقًا.
بالنسبة لواجهة Graph API بالإصدار 26.0 والإصدارات الأحدث:
pretty، وتستخدم استجابات JSON تنسيقًا مدمجًا. تنسيق JSON في أدوات أو رموز العملاء.debug، ولا تتم إضافة أي مغلف لاستجابة تصحيح الأخطاء. استخدِم أدوات تصحيح الأخطاء القياسية. لا تتأثر نقطة النهاية debug_token.date_format تؤدي إلى خطأ في المعلمة. استخدم تنسيق التاريخ الافتراضي وقم بتحويل القيم على المستوى المحلي إذا لزم الأمر.GET /?ids=... إلى إرجاع خطأ في المعلمة. استخدم طلبات لكل كائن أو التجميع المدعوم.If-None-Match. تتم إزالة عناوين استجابة ETag القديمة وسلوك 304 Not Modified، وتُرجع الطلبات استجابات كاملة.ابتداءً من 27 أكتوبر 2026، ستُطبَّق هذه التغييرات على جميع إصدارات واجهة Graph API المدعومة المتبقية. يُرجى مراجعة سجلات طلبات وقت التشغيل وسجل تغييرات واجهة Graph API بالإصدار 26.0 للحصول على تفاصيل الترحيل.
مسودة منشور مدونة المطوّر. عرض الإصدار: الإصدار 26.0 من Graph API. نوع التغيير: إيقاف الاستخدام (90 يومًا).
ملخص
بالنسبة إلى صفحات تجربة الصفحات الجديدة، يتم إيقاف استخدام خمسة حقول عقدة صفحة قديمة (current_location, genre, network, parking, start_info) وإعداد الصفحة auto_publish_page_info_updates بدءًا من الإصدار 26.0 من Graph API. لم تعد تتم صيانة هذه الحقول ويجب عدم الوصول إليها في صفحات تجربة الصفحات الجديدة.
اليوميات
ما الذي تغيَّر
في الإصدار 26.0 والإصدارات الأحدث، يؤدي طلب أي من هذه الحقول الخمسة في صفحة تجربة الصفحات الجديدة إلى إرجاع خطأ في الإصدار، ولم يعد الإعداد auto_publish_page_info_updates يظهر في استجابة إعدادات الصفحة. في الإصدارات السابقة، لا يتغير السلوك حتى انتهاء مدة الترحيل البالغة 90 يومًا، وبعد ذلك ينطبق الأمر نفسه على جميع الإصدارات.
نقاط النهاية المتأثرة:
/{page-id}?fields=current_location/{page-id}?fields=genre/{page-id}?fields=network/{page-id}?fields=parking/{page-id}?fields=start_info/{page-id}?fields=settings - تمت إزالة إعداد auto_publish_page_info_updates من قائمة الإعدادات التي تم إرجاعهاما يجب على المطورين القيام به
auto_publish_page_info_updates من طلبات صفحتك.المرجع
بدءًا من 29 يوليو 2026، باستخدام الإصدار 26.0 من واجهة API التسويق، سيتم تعيين المعلمة advantage_audience الموجودة ضمن targeting_automation تلقائيًا إلى 1 بشكل افتراضي لعمليات إعداد الجمهور الافتراضية أو المبسّطة بالكامل. بالنسبة إلى إعدادات الجمهور المقيدة، يجب على المطورين تعيين advantage_audience بوضوح إلى إما 1 أو 0 للحملات الإعلانية في فئات الإسكان أو التوظيف أو المنتجات والخدمات المالية ضمن الفئات الإعلانية الخاصة.
ينطبق هذا السلوك فقط عند إنشاء مجموعة إعلانية جديدة. لن يؤدي تحديث المجموعة الإعلانية الموجودة إلى إظهار هذا السلوك على أي إصدار من إصدارات API.
هذا هو السلوك ذاته الذي تم تقديمه للحملات الإعلانية خارج الفئات الإعلانية الخاصة في الإصدار 23.0 من واجهة API التسويق. اطلع على وثائق اكتشاف مشكلات الجمهور باستخدام Advantage+ وحلها لمعرفة التفاصيل.
نقاط نهاية واجهة API التالية متأثرة:
/{ad-account-id}/adsets/{adset-id}/{adset-id}/copiesاعتبارًا من 29 يوليو 2026، لن يكون موضع موجز الاستكشاف على Instagram متوفرًا، وذلك بدءًا من الإصدار v26.0 من واجهة API التسويق. وسيتوقف العرض في "استكشاف"، وسيتم تحويل إنفاق الحملة الإعلانية تلقائيًا إلى المواضع المؤهلة الأخرى.
ستؤدي محاولة إنشاء مجموعة إعلانية تحدد موضع الاستكشاف أو تحديثها إلى إرجاع خطأ. يجب على المطورين إزالة "استكشاف" من تكوينات المواضع واستخدام المواضع المؤهلة الأخرى.
نقاط النهاية التالية متأثرة:
/act_{ad-account-id}/adsets/{ad-set-id}بدءًا من 29 يوليو 2026، باستخدام الإصدار 26.0 من واجهة API التسويق، لن يتمكن المطورون من إرفاق تصميم إعلان يتضمن applink_treatment تم تعيينها إلى web_only بإعلان في حملة إعلانية تستخدم موقعَي التحويل "موقع الويب" و"التطبيق". يؤثر هذا في إنشاء الإعلانات والتحديثات من خلال POST /act_{ad-account-id}/ads وPOST /{ad-id}.
نقطة نهاية تصميم الإعلان لا تتغير، ولكن POST /act_{ad-account-id}/adcreatives هي المكان الذي يتم فيه تكوين القيمة applink_treatment. يجب على المطوّرين مراجعة عمليات الدمج الخاصة بهم في applink_treatment=web_only واستخدام تحديد الوجهة التلقائية أو تحديد وجهة يدوية أخرى متوافقة للحملات الإعلانية لموقع الويب والتطبيق.
في 27 أكتوبر 2026، بعد 90 يومًا من إصدار الإصدار 26.0، سيتم تطبيق هذا التقييد على جميع إصدارات واجهة API التسويق. راجع وثائق الإعلان وتصميم الإعلان للحصول على مزيد من المعلومات.
بدءًا من الإصدار 26.0 من واجهة API التسويق في 29 يوليو 2026، لن تكون القيمة story في messenger_positions متوفرة عند إنشاء المجموعات الإعلانية أو تحديثها من خلال استدعاءات الإصدار 26.0 أو الإصدارات الأحدث.
بالنسبة لهذه المكالمات، ستتم إزالة story من مواصفات الاستهداف ولن تظهر بعد الآن في المواضع الفعالة للمجموعات الإعلانية الجديدة أو الحالية. قد تستمر بيانات الاستهداف السابقة في تضمين story عند الطلب من خلال GET /{ad_set-id}?fields=targeting. لن يتم إرجاع أي خطأ مخصص، ولكن قد تنطبق أخطاء التحقق القياسية من صحة الموضع إذا أدت إزالة story إلى ترك تكوين موضع غير صالح.
نقاط النهاية التالية متأثرة:
/act_{ad-account-id}/adsets/{ad_set-id}يجب على المطورين الذين يستخدمون المواضع اليدوية إزالة story من messenger_positions. إذا كانت هذه هي القيمة الوحيدة، فقم بإزالة حقل messenger_positions بالكامل وفكِّر في إزالة messenger من publisher_platforms عند عدم استخدام موضع Messenger آخر، مثل marketing_messages. لا يلزم اتخاذ أي إجراء لمواضع Advantage+.
لا يؤثر هذا التغيير الذي يخص واجهة API فقط في مدير الإعلانات. ولن تتأثر مبدئيًا الاستدعاءات غير محددة الإصدار والاستدعاءات إلى إصدارات أقدم من الإصدار 26.0. في 27 أكتوبر 2026، بعد 90 يومًا من إصدار الإصدار 26.0، سيتم تطبيق إيقاف الاستخدام على جميع إصدارات واجهة API التسويق، بما في ذلك الاستدعاءات غير المحددة الإصدار.
بدءًا من الإصدار 26.0 من واجهة API التسويق في 29 يوليو 2026، لن يتم دعم مكونات استطلاع الرأي عند إنشاء الإعلانات وتصميمات الإعلانات أو تحديثها. لن يصبح حقل poll_spec وقيمة "poll" للحقل type متوفرين ضمن interactive_components_spec.
سيتم رفض الطلبات التي تقوم بإنشاء تصميم استطلاع رأي أو تغيير إعلان لاستخدام تصميم استطلاع رأي. يمكن استمرار تحديثات الإعلان الحالي التي لا تغيّر تصميمه، مثل تغييرات الحالة أو الميزانية أو الجدول الزمني.
نقاط النهاية التالية متأثرة:
يجب على المطورين إزالة الحقول المتعلقة باستطلاع الرأي من مواصفات التصميمات الخاصة بهم واستخدام تصميم لا يتضمن مكون استطلاع رأي. لا تتأثر مبدئيًا الاستدعاءات إلى إصدارات سابقة للإصدار 26.0 والاستدعاءات غير محددة الإصدار.
في 27 أكتوبر 2026، بعد 90 يومًا من إصدار الإصدار 26.0، سيتم تطبيق هذا الإيقاف على جميع إصدارات واجهة API التسويق.
سيتم نشر الإصدار 26 من مجموعة SDK للأعمال من Meta بعد وقت قصير من طرح الإصدار 26 لواجهة Graph API. وسيتضمن هذا الإصدار ترقيات التبعية،ودمج أداة إنشاء معلمات واجهة API التحويلات وميزات واجهة API الجديدة، وإيقاف استخدام واجهة API إدارة الطلبات التجارية والعديد من ميزات البروتوكول القديمة.
تم الآن دمج مجموعة SDK للأعمال مع أداة إنشاء معلمات واجهة API التحويلات مفتوحة المصدر. يمكنك الاستفادة من هذا الدمج الجديد لتحسين جودة دمج واجهة API التحويلات لديك. الميزات الأساسية: إنشاء تلقائي (يتم التحكم فيه من خلال التفضيلات التي يقوم المعلنون بتعيينها) وتحسين المعلمات fbc وfbp وevent_source_url وreferrer_url وclient_ip_address وتسوية/تجزئة تلقائية لمعلومات تحديد الهوية الشخصية للغات المدعومة، اطَّلِع على المزيد هنا. تم إيقاف استخدام واجهة API إدارة الطلبات التجارية (47 نقطة نهاية) تمامًا دون بديل. تتم إزالة موضع إعلان موجز الاستكشاف على Instagram ويعرض أخطاءً في حالة تحديده. تمت إزالة موضع Messenger Stories دون إشعار من messenger_positions. اكتسبت الإعلانات في حالة واتساب إمكانيات جديدة بما في ذلك مواصفات الهوية، والعنصر الدوّار الذي يضم ما يصل إلى 10 بطاقات، وتحسين التحويل خارج الموقع.
كجزء من مخطط الإيقاف لمدة عامين لمجموعات SDK المنصة، يُرجى ملاحظة حالات إيقاف الاستخدام والإلغاء القادمة:
كجزء من مخطط تعيين الإصدارات على فيسبوك لواجهة Graph API، يُرجى ملاحظة حالات إيقاف الاستخدام القادمة:
لتجنُّب أي تعطُّل، يُرجى ترحيل كل الاستدعاءات إلى أحدث إصدار من واجهة API.
بادر بالتسجيل للحصول على التحديثات الشهرية من Meta للمطوّرين.