مستويات الوصول المُدارة من خلال السحابة الإلكترونية

ملاحظة: تقبل Google الاشتراكات المبكرة في هذا البرنامج الذي من المقرّر إطلاقه في أواخر عام 2023. الاشتراك

تتيح هذه الميزة إدارة مستويات الوصول إلى واجهة برمجة التطبيقات من خلال مؤسسة في Google Cloud، ما يمنحك المزايا التالية:

• لم تعد هناك حاجة لتأمين الرموز المميزة للمطوِّرين: تتم إدارة الوصول إلى واجهة برمجة التطبيقات من خلال مؤسسة Google Cloud، لذا لا داعي للقلق بشأن تأمين الرموز المميزة للمطوِّرين أو تسرُّبها. يمكنك تخطي إرسال الرمز المميز للمطوِّر في طلبات البيانات من واجهة برمجة التطبيقات، على الرغم من أنّك لا تزال بحاجة إلى إرسال رمز دخول.

• الاحتفاظ بمشاريع منفصلة على Google API Console لتطبيقات مختلفة: يكتسب أي مشروع مرتبط ضمن مؤسسة Google Cloud مستوى الوصول إلى واجهة برمجة التطبيقات للمؤسسة. ويتيح لك ذلك إنشاء عدة مشاريع متعددة لوحدة تحكم واجهة برمجة تطبيقات Google ضمن هذه المؤسسة لأغراض مثل إدارة المشاريع الدقيقة، والمشروعات المنفصلة لتطبيقات مختلفة، ومشاريع متعددة لوحدة تحكم واجهة برمجة تطبيقات Google لأعضاء فريقك.

• مراقبة الحصص الأكثر دقة وإدارتها: يمكنك مراقبة استخدام واجهة برمجة التطبيقات للمشروعات الفردية أو استخدام واجهة برمجة التطبيقات "cap API".

المتطلبات الأساسية

• الرمز المميز للمطوِّر الموافَق عليه

  يجب أن يكون لديك رمز مميز معتمد للمطوِّر لاستخدام هذا الخيار. يمكنك العثور على الرمز المميز الحالي للمطوِّر في صفحة مركز واجهة برمجة التطبيقات ضمن حسابك الإداري على "إعلانات Google". سجّل الدخول، ثم انتقِل إلى الأدوات والإعدادات > الإعداد > مركز واجهة برمجة التطبيقات.

• مؤسسة على Google Cloud

  تربط Google Ads API الرمز المميّز للمطوِّر بمؤسسة على Google Cloud وتستخدمه لتحديد مستويات الوصول إلى واجهة برمجة التطبيقات. هناك طرق متعددة لإنشاء مؤسسة Google Cloud.

  السيناريو	الخطوات
  أن تكون عميلاً حاليًا في Google Workspace أو Google Cloud Identity	من المحتمل أن يكون لديك مورد مؤسسة بالفعل. يمكنك التحقّق وإنشاء حساب إذا لزم الأمر.
  عدم استخدام Google Workspace أو Google Cloud Identity	اشترِك في الإصدار المجاني من Google Cloud Identity. بعد ذلك، يمكنك إنشاء مرجع لمؤسستك.
  لا يناسبك أي من الخيارات السابقة.	يُرجى شرح السيناريو عند الاشتراك في التشغيل التجريبي والطلب من Google إنشاء مورد مؤسسة لك. ستمتلك Google مورد المؤسسة هذا وتديره بدون أي رسوم.

• إعداد مشاريع وحدة تحكُّم Google API للبرنامج التجريبي

  يجب تحضير مشاريع وحدة تحكُّم Google API التي تستخدمها مع Google Ads API للبرنامج التجريبي على النحو التالي:

  السيناريو	الخطوات
  أنت تملك حاليًا مؤسسة على Google Cloud أو أنشأت مؤسسة في الخطوة السابقة.	تأكَّد من أنّ جميع مشاريع وحدة تحكُّم Google API التي تم فيها تفعيل Google Ads API تابعة لهذه المؤسسة. وإذا لم تكن كذلك، يمكنك نقلها ضمن المؤسسة. إذا كنت عميلاً حاليًا في Google Workspace أو Google Cloud Identity، من المحتمل أن تكون مشاريع Google API Console تابعة لمؤسستك حاليًا، لذا يمكنك تخطّي هذه الخطوة.
  لا تملك مؤسسة على Google Cloud ولم تتمكّن من إنشاء مؤسسة في الخطوة السابقة.	تأكَّد من أنّك مستخدِم مشرف في حسابك الإداري على Google Ads API ومشروعك على وحدة تحكّم Google API Console. ويجب الحصول على هذا الإذن لتنفيذ خطوات إضافية بعد الموافقة على طلبك للانضمام إلى البرنامج التجريبي.

• عنوان بريد إلكتروني حديث للتواصل مع واجهة برمجة التطبيقات

  تأكد من أن عنوان البريد الإلكتروني لجهة اتصال Google Ads API محدّث. تظهر تفاصيل الاتصال بواجهة برمجة التطبيقات في صفحة مركز واجهة برمجة التطبيقات في حسابك الإداري على Google Ads API. سجّل الدخول، ثم انتقِل إلى الأدوات والإعدادات > الإعداد > مركز واجهة برمجة التطبيقات.

الاشتراك في البرنامج التجريبي

يمكنك الاشتراك في برنامج التشغيل التجريبي. سيراجع فريق الامتثال في Google طلبك بعد ذلك ويرسل رسالة إلكترونية إلى عنوان البريد الإلكتروني لجهة اتصال واجهة برمجة التطبيقات مع حالة الموافقة والتفاصيل الإضافية.

إذا طلبت من Google إنشاء مؤسسة Google Cloud نيابةً عنك، هناك بعض الخطوات الإضافية المطلوب اتّخاذها:

1. ستنشِئ Google لك مورد مؤسسة على Cloud تملكه Google. سيتم منح جميع مشرفي حسابك الإداري في Google Ads API الدور roles/resourcemanager.projectCreator على المؤسسة التي تم إنشاؤها حديثًا.

2. سترسل Google بريدًا إلكترونيًا إلى عنوان البريد الإلكتروني لجهة اتصال واجهة برمجة التطبيقات مع تفاصيل مورد المؤسسة الذي تم إنشاؤه حديثًا.

3. يجب تسجيل الدخول إلى حسابك على وحدة تحكُّم واجهة برمجة تطبيقات Google واتّباع التعليمات لنقل مشروع وحدة تحكُّم واجهة برمجة تطبيقات Google إلى المؤسسة الجديدة.

4. عليك الرد على الرسالة الإلكترونية لإخبار Google بأن مشروعاتك تم نقلها إلى المؤسسة الجديدة.

5. سيراجع فريق الامتثال في Google طلبك ويرسل رسالة إلكترونية إلى عنوان البريد الإلكتروني المخصّص للتواصل مع واجهة برمجة التطبيقات مع حالة الموافقة والتفاصيل الإضافية.

تعديل طلبات البيانات من واجهة برمجة التطبيقات

يمكنك تعديل تطبيقك لإيقاف إرسال عنوان developer-token عند إجراء طلبات بيانات من واجهة برمجة التطبيقات. هذه خطوة اختيارية لكننا ننصح بها. إذا كنت مشاركًا في البرنامج التجريبي، يتجاهل خادم Google Ads API developer-token في حال إرساله كجزء من طلبات البيانات من واجهة برمجة التطبيقات.

Java

سنطرح الميزة قريبًا.

NET.

نزِّل الإصدار 17.1.0 أو إصدار أحدث من مكتبة .NET لواجهة Google Ads API.

بعد ذلك، عدِّل التعليمة البرمجية على النحو التالي:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

سنطرح الميزة قريبًا.

Python

سنطرح الميزة قريبًا.

Ruby

سنطرح الميزة قريبًا.

Perl

سنطرح الميزة قريبًا.

عميل HTTP (REST)

احذف عنوان developer-token في طلبات HTTP:

curl -i -X POST https://googleads.googleapis.com/v16/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

الأسئلة الشائعة

هل يعني هذا التغيير أنّه يجب أن أكون عميل Google Workspace أو Google Cloud حتى أتمكن من استخدام Google Ads API؟

لا، أنت بحاجة إلى مؤسسة في Google Cloud يمكن الحصول عليها بعدة طرق. هذا الشرط يشبه الطريقة التي تحتاج بها إلى مشروع على وحدة تحكّم Google API حتى تتمكّن من استخدام Google Ads API حاليًا.

أريد تغيير مستويات الوصول إلى واجهة برمجة التطبيقات. كيف يمكنني تنفيذ ذلك؟

عليك مواصلة استخدام "مركز واجهة برمجة التطبيقات" في الوقت الحالي لطلب أي تغييرات على مستويات الوصول إلى واجهة برمجة التطبيقات.

هل هناك أي توقُّف عن الاشتراك في هذا الإصدار التجريبي؟

لا، ما مِن طريقة لإجراء ذلك. ستبدأ Google Ads API تلقائيًا في استخدام مستويات الوصول إلى واجهة برمجة التطبيقات على مستوى المؤسسة بعد الموافقة عليها.

ما مقدار الجهد المطلوب للمشاركة في هذا البرنامج التجريبي؟

توقَّع الحد الأدنى من التغييرات في الرمز. من المفترض أن يتمكن معظم المطورين من إكمال التغييرات في تطبيقاتهم في أقل من 30 دقيقة.

هل سيتم تحصيل رسوم مني إذا اشتركت في هذا البرنامج التجريبي؟

بشكل عام، لا، لن يتم تحصيل أي رسوم منك في حال اشتراكك في هذا البرنامج التجريبي. تتوفّر واجهة Google Ads API بدون أي رسوم، ولا تُجري Google أي تغييرات على نموذج أسعار Google Ads API.

وفي ما يلي السيناريوهات المحتملة للحصول على مؤسسة Google Cloud:

1. إذا كنت عميلاً حاليًا في Google Workspace أو Google Cloud Identity:

   سيتم تحصيل الرسوم منك كالمعتاد مقابل أي استخدام منتظم لهذه المنتجات. ولن يتم تحصيل أي رسوم منك مقابل إنشاء مؤسسة Google Cloud بغرض المشاركة في هذا البرنامج التجريبي.

2. أنشأت حسابًا في الإصدار المجاني من Google Cloud Identity:

   لن يتم تحصيل أي رسوم منك عند الاشتراك في حساب الإصدار المجاني من Google Cloud Identity أو إنشاء مؤسسة Google Cloud بغرض المشاركة في هذا البرنامج التجريبي.

3. أنشأت Google موردًا للمؤسسات على السحابة الإلكترونية من أجلك:

   وهذا مورد مؤسسة سحابية داخلي تديره Google، لذا لن يتم تحصيل أي رسوم منك كنتيجة لذلك.

لديّ العديد من الرموز المميّزة للمطوِّر لأدوات مختلفة. ما هو تأثير هذا البرنامج التجريبي فيّ؟

حالة الاستخدام هذه غير متاحة، لذا لن تتمكّن من المشاركة في هذا البرنامج التجريبي.

هل يؤثر ذلك في أي تفويض حالي لواجهة برمجة التطبيقات للحسابات التي أديرها باستخدام Google Ads API؟

لا، لا يؤثر هذا التغيير في أي تفويضات حالية لواجهة برمجة التطبيقات لحسابات "إعلانات Google" التي تديرها باستخدام Google Ads API.

لقد اشتركتُ في هذا البرنامج التجريبي وأواجه مشاكل أو ملاحظات. كيف أتصل بالدعم؟

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