فصل الموافقة في Ads API

الخميس 20 فبراير 2025

ما الذي سيتغيّر؟
اعتبارًا من الأسبوع الذي يبدأ في 1 مايو 2025، سنطرح ميزة إلغاء تجميع الموافقة لمصادقة مستخدمي OAuth في جميع مشاريع Google Cloud التي تم إنشاؤها قبل عام 2019. إذا كنت تملك تطبيقًا يستخدم واجهة برمجة تطبيقات مرتبطة بـ "إعلانات Google" من خلال مشروع على Google Cloud تم إنشاؤه قبل عام 2019، قد تحتاج إلى تعديل تطبيقك للتعامل مع موافقة المستخدم غير المجمّعة قبل 1 مايو 2025.

نظرة عامة
تتيح ميزة "فصل الموافقة" في مسار مصادقة المستخدمين عبر OAuth للمستخدمين تخصيص نطاقات OAuth المحدّدة التي يريدون منح تطبيقك الإذن بالوصول إليها، بدلاً من الموافقة على كل النطاقات أو رفضها بالكامل. تكون هذه الميزة مفعَّلة في جميع مشاريع Google Cloud Console التي تم إنشاؤها منذ عام 2019، في حين تكون غير مفعَّلة في جميع المشاريع التي تم إنشاؤها قبل عام 2019.

مَن سيتأثر بهذا التغيير؟
سيتأثر حسابك بهذا التغيير في حال استيفاء جميع الشروط التالية:

1. يستخدم تطبيق واجهة برمجة التطبيقات مشروعًا على Google Cloud Console تم إنشاؤه قبل عام 2019.
2. يستخدم تطبيقك سير عمل موافقة المستخدم في OAuth 2.0، وهو سير عمل للمصادقة يسجّل فيه المستخدم الدخول باستخدام حسابه على Google ويمنح إذنًا واحدًا أو أكثر يطلبه تطبيقك.
3. يستخدم تطبيقك أكثر من واجهة برمجة تطبيقات واحدة من Google، وإحدى واجهات برمجة التطبيقات هذه هي واجهة برمجة تطبيقات مرتبطة بالإعلانات ومُدرَجة أدناه.

مَن لن يتأثر بهذا التغيير؟

• الرموز المميّزة الحالية لإعادة التحميل: لا يؤثّر هذا التغيير في عمليات مصادقة المستخدمين التي سبق لك إعدادها. ستستمر الرموز المميزة لإعادة التحميل الحالية في العمل بدون أي تغييرات أو إعادة مصادقة.
• التطبيقات ذات النطاق الواحد: إذا كان تطبيقك يستخدم نطاقًا واحدًا فقط من Google API، لن يتأثر بهذا التغيير، لأنّه لا يتضمّن نطاقات OAuth متعددة يمكن فصلها.
• التطبيقات المخصّصة لمستخدم واحد أو التطبيقات التي تتم مصادقتها يدويًا: لا يتضمّن تطبيقك مسارًا واضحًا لمصادقة مستخدمي OAuth. بدلاً من ذلك، يمكنك استخدام نص برمجي يدوي للمصادقة، مثل GenerateUserCredentials أو gcloud CLI أو OAuth Playground لمصادقة المستخدم، ثم استخدام بيانات الاعتماد هذه لفترة زمنية طويلة. بما أنّك تختار جميع النطاقات التي يتطلّبها تطبيقك أثناء المصادقة، لن يتأثّر تطبيقك بهذا التغيير.
• حسابات الخدمة: إذا كان تطبيقك يستخدم حساب خدمة لمصادقة طلبات البيانات من واجهة برمجة التطبيقات، لن تتأثر بهذا التغيير

الإجراء المطلوب اتخاذه
يجب التأكّد من أنّ تطبيقك يمكنه التعامل مع موافقة المستخدم الجزئية. للقيام بذلك،

1. اطلب قائمة نطاقات OAuth التي وافق عليها المستخدم من خلال تضمين المَعلمة include_granted_scopes في مسار OAuth.
2. افحص القائمة الفعلية لنطاقات OAuth التي وافق عليها المستخدم في استجابة OAuth.
3. تنفيذ التفويض المتزايد في تطبيقك

يُرجى مراجعة دليل الموافقة الدقيقة في OAuth للتعرّف على المتطلبات وأفضل الممارسات للتعامل مع الموافقة الدقيقة.

كيف يمكنني اختبار هذه الميزة؟
هناك طريقتان لاختبار هذه الميزة:

1. إنشاء مشروع جديد على Google Cloud: تم تفعيل ميزة "إلغاء تجميع موافقات OAuth" في المشاريع الجديدة على Google Cloud. لذا يمكنك إنشاء مشروع جديد على Google Cloud واستخدامه لاختبار تطبيقك.
2. تفعيل ميزة "فصل الموافقة" في مشروعك الحالي: يمكنك ضبط المَعلمة enable_granular_consent على "صحيح" في طلب تفويض OAuth.

ما هي نطاقات واجهة برمجة التطبيقات المتأثرة؟
ستتأثر واجهات برمجة التطبيقات التالية المرتبطة بـ "إعلانات Google" بهذا التغيير.

واجهة برمجة التطبيقات	نطاق OAuth
Google Ads API	https://adwords.google.com/api/adwords
‫Google Ad Manager API (SOAP API، إصدار تجريبي)	https://www.googleapis.com/auth/dfp https://www.googleapis.com/auth/admanager
Bid Manager API	https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping	https://www.googleapis.com/auth/content
Display and Video 360 API	https://www.googleapis.com/auth/display-video-mediaplanning https://www.googleapis.com/auth/display-video-user-management
AdMob API	https://www.googleapis.com/auth/admob.report https://www.googleapis.com/auth/admob.googlebidding.readwrite https://www.googleapis.com/auth/admob.monetization
واجهة برمجة التطبيقات في "AdSense للمنصات"	https://www.googleapis.com/auth/adsensehost https://www.googleapis.com/auth/adsense https://www.googleapis.com/auth/adsense.readonly
Google Analytics API	https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.provision https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API	https://www.googleapis.com/auth/ddmconversions https://www.googleapis.com/auth/dfareporting https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API	https://www.googleapis.com/auth/doubleclicksearch
Google Tag Manager API	https://www.googleapis.com/auth/tagmanager.delete.containers https://www.googleapis.com/auth/tagmanager.edit.containers https://www.googleapis.com/auth/tagmanager.edit.containerversions https://www.googleapis.com/auth/tagmanager.manage.accounts https://www.googleapis.com/auth/tagmanager.manage.users https://www.googleapis.com/auth/tagmanager.publish https://www.googleapis.com/auth/tagmanager.readonly
واجهة برمجة التطبيقات لعرض الأسعار في الوقت الفعلي	https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API	https://www.googleapis.com/auth/authorized-buyers-marketplace https://www.googleapis.com/auth/adexchange.buyer

كيفية الحصول على المساعدة
إذا كانت لديك أي أسئلة أو كنت بحاجة إلى المساعدة، يُرجى التواصل مع فريق الدعم المعني بواجهة برمجة التطبيقات.

 - Anash P. "أومن"، فريق Google Ads API

التصنيفات: المصادقة، oauth