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

تتيح لك هذه الميزة إدارة مستويات الوصول إلى واجهة برمجة التطبيقات من خلال مؤسسة 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 مورد مؤسسة على Cloud تملكه 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 إذا تم إرساله كجزء من طلبات البيانات من واجهة برمجة التطبيقات.

جافا

قريبًا:

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/v25/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"

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

في ما يلي بعض الأسئلة الشائعة حول مستويات الوصول المُدارة على Cloud.

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

لا، أنت بحاجة إلى مؤسسة على Google Cloud، ويمكن الحصول عليها بعدة طرق. يشبه هذا المتطلب الحاجة إلى مشروع على Google API Console لاستخدام 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 مورد مؤسسة على Cloud لك:

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

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

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

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

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

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

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