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

ملاحظة: تقبل Google طلبات الانضمام إلى هذا البرنامج. الاشتراك

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

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

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

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

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

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

  يجب أن يكون لديك رمز مميّز معتمَد للمطوّرين لاستخدام هذا الخيار. يمكنك العثور على رمز مميز حالي للمطوِّر في "مركز واجهة برمجة التطبيقات" ضمن حسابك الإداري على "إعلانات 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 Console للبرنامج التجريبي

  عليك إعداد مشاريع Google API Console التي تستخدمها مع Google Ads API للبرنامج التجريبي على النحو التالي:

  السيناريو	الخطوات
  لديك مؤسسة على Google Cloud أو أنشأت واحدة في الخطوة السابقة	تأكَّد من أنّ جميع المشاريع في Google API Console التي فعّلت فيها 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 مورد مؤسسة في السحابة الإلكترونية تملكه. سيتم منح جميع مشرفي حسابك الإداري على Google Ads API الدور roles/resourcemanager.projectCreator في المؤسسة التي تم إنشاؤها حديثًا.

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

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

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

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

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

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

Java

قريبًا:

NET.

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

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

// 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/v20/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 Console لاستخدام واجهة Google Ads API حاليًا.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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