موافقات الجهات المتعددة في Google Ads API

الخميس 25 يونيو 2026

في إطار تحسين أمان حسابات "إعلانات Google"، ستبدأ Google Ads API في طلب موافقات جهات متعددة عند تنفيذ إجراءات حسّاسة في واجهة برمجة التطبيقات. هذا جزء من تغيير أوسع نطاقًا في "إعلانات Google" يتطلّب موافقة جهات متعددة لتنفيذ إجراءات حسّاسة في حسابك على "إعلانات Google". سيتم طرح تحديثات الأمان المهمة هذه بدءًا من 27 يوليو 2026، وسيتم تطبيقها لجميع المستخدمين خلال الأسابيع القليلة المقبلة.

ما الذي سيتغيّر؟

عند تطبيق هذا التغيير، سيتغيّر سلوك طلبات البيانات التالية من واجهة برمجة التطبيقات.

دعوة مستخدم

إذا كنت تستخدم طريقة CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation من أجل دعوة مستخدم جديد لإدارة حساب على "إعلانات Google"، ستقيّم Google Ads API الآن ما إذا كانت ميزة "موافقة جهات متعدّدة" ضرورية. في الحالات التي تحدّد فيها خوادمنا أنّ المراجعة مطلوبة، سيوقف النظام سير العمل العادي مؤقتًا ولن ينشئ على الفور CustomerUserAccessInvitation أو يرسل دعوة بالبريد الإلكتروني. بدلاً من ذلك، يتم بدء مورد MultiPartyAuthReview، مع تقديم اسم المورد في الردّ. بعد أن يوافق مشرف حساب ثانٍ على المراجعة المعلّقة، سيتم إنشاء CustomerUserAccessInvitation وسيتلقّى المستخدم المدعو رسالته الإلكترونية. لا يمكن إنشاء دعوات جديدة للمستخدم إلى أن تتم معالجة المراجعة المعلّقة.

تعديل إذن وصول المستخدم أو إنهاؤه

إذا كنت تستخدِم طريقة CustomerUserAccessService.MutateCustomerUserAccess لتعديل أذونات مستخدم باستخدام عملية التعديل أو إبطال إذن الوصول باستخدام عملية الإزالة، ستقيّم Google Ads API الآن ما إذا كانت الموافقة من جهات متعددة ضرورية. في الحالات التي تحدّد فيها خوادمنا أنّ المراجعة مطلوبة، تنشئ واجهة برمجة التطبيقات مورد MultiPartyAuthReview في حالة انتظار المراجعة وتعرض اسم المورد. ستبقى التعديلات المطلوبة في انتظار المراجعة ولن تسري إلا بعد موافقة مشرف ثانٍ على الحساب على مراجعة الجهات المتعددة. لا يمكن تعديل CustomerUserAccess قيد المراجعة إلى أن يتم حلّ المراجعة المعلّقة.

كيف يمكنني الموافقة على طلب موافقة جهات متعددة؟

يمكنك جلب MultiPartyAuthReview في انتظار المراجعة باستخدام الطريقتَين GoogleAdsService.Search أو GoogleAdsService.SearchStream، وذلك من خلال طلب البحث التالي في GAQL. 

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

يمكن الموافقة على طلب MultiPartyAuthReview معلَّق أو رفضه باستخدام طلب بيانات من واجهة برمجة التطبيقات MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. يجب أن تتم المراجعة من قِبل مشرف ثانٍ لم ينشئ الطلب الأصلي. ويمكن أن يكون هذا المستخدم شخصًا أو حساب خدمة لديه امتيازات المشرف. يمكن لمقدّم الطلب الأصلي إلغاء المراجعة المعلّقة.

الإجراء المطلوب اتخاذه

إذا كان تطبيقك يستخدم هذه الطُرق، يجب تحديثه قبل 27 يوليو 2026 للتعامل مع مهام سير العمل التي تتطلب موافقة جهات متعددة. أضفنا ميزة الموافقة من جهات متعددة إلى جميع الإصدارات الرئيسية من واجهة برمجة التطبيقات (الإصدارات 24.2 و23.3 و22.2 و21.2). إذا كنت تستخدم مكتبة عملاء رسمية، تأكَّد من تنزيل أحدث إصدار منها. يمكنك الاطّلاع على الأدلة التالية لمزيد من المعلومات حول هذه التغييرات، والتي تتضمّن تفاصيل حول:

إذا كانت لديك أي أسئلة أو أردت مناقشة هذا التعديل، يُرجى التواصل معنا على خادم Discord الخاص بـ "منتدى Google للإعلانات والقياس". إذا واجهتك مشاكل في الدعم الفني، يُرجى التواصل معنا على الرابط https://support.google.com/google-ads/contact/google_ads_api

صورة للمؤلف - ، فريق Google Ads API

التصنيفات: authorization، google-ads-api