الأربعاء 4 نوفمبر 2026
في وقت سابق من هذا العام، بدأت Google Ads API بطلب موافقة جهات متعددة (MPA) عند تنفيذ إجراءات حسّاسة في واجهة برمجة التطبيقات. اعتبارًا من أسبوع 7 ديسمبر 2026، سنقدّم تغييرات إضافية لتحسين تجربة المطوّرين في ما يتعلّق بالموافقات المتعدّدة الأطراف.
ما الذي سيتغيّر؟
تأجيل إنشاء دعوة الوصول: إذا كانت موافقة جهات متعددة مطلوبة، ستؤجّل طريقة CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation إنشاء مورد دعوة الوصول إلى أن تتم الموافقة على طلب موافقة جهات متعددة. ولا تتم تعبئة حقل resource_name في هذه الحالات. بعد الموافقة على طلب الموافقة المتعدّدة الجهات المعلّق، يصبح مورد دعوة الوصول متاحًا من نتائج المراجعة. في الوقت الحالي، تنشئ هذه الطريقة الدعوة وتعرض resource_name الخاص بها، ولكنّها لا تنفّذ إجراءات إضافية مثل إرسال دعوة بالبريد الإلكتروني إلى أن تتم الموافقة على طلب الموافقة المتعدّدة الجهات المرتبط بها.
رمز خطأ جديد للطلبات القديمة: سنبدأ في عرض رمز خطأ MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST جديد في حقل الخطأ الجزئي عندما لا يعود طلب الموافقة المتعدّدة الجهات المعلّق صالحًا بسبب تعديل المورد المستهدَف أو حذفه بعد إنشاء المراجعة. سيتم طرح رمز الخطأ هذا في الإصدار 26.2 القادم. ستعرض إصدارات واجهة برمجة التطبيقات القديمة (من الإصدار 23 إلى الإصدار 25) الخطأ MultiPartyAuthReviewError.UNKNOWN، وسيتم ضبط الحقل unpublished_error_code في GoogleAdsError.details على MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST.
زيادة الحدّ الأقصى لعدد مراجعات MPA: يمكنك حلّ ما يصل إلى 100 مراجعة MPA في انتظار المراجعة من خلال طلب واحد لطريقة MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. في الوقت الحالي، تقتصر هذه الطريقة على مراجعة واحدة لكل طلب بيانات من واجهة برمجة التطبيقات.
يجب اتخاذ إجراء
إذا كنت تستخدم الموافقات المتعددة الأطراف، يُرجى مراجعة الرمز البرمجي وتعديله ليعكس سلوك واجهة برمجة التطبيقات الجديد قبل 7 ديسمبر 2026. إذا كنت تستخدم الإصدار 26 من Google Ads API، نزِّل أحدث مكتبات برامج بعد طرح الإصدار 26.2 للحصول على دعم لرمز الخطأ الجديد STALE_MULTI_PARTY_AUTH_REQUEST. يُرجى الرجوع إلى الأدلة الفنية لمزيد من المعلومات عن الموافقات المتعددة الأطراف. إذا واجهتك مشاكل في الدعم الفني، يُرجى التواصل مع فريق دعم Google Ads API. إذا كانت لديك أي أسئلة أو أردت مناقشة هذا المنشور، يُرجى التواصل معنا على خادم Discord الخاص بـ "منتدى Google للإعلانات والقياس".
- Anash P. "أومن"، فريق Google Ads API
التصنيفات: authorization، google-ads-api، release