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

ملاحظة: تقبل 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". تحتاج إلى هذا الإذن لتنفيذ خطوات إضافية بعد الموافقة على طلبك التجريبي.

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

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

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

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

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

1. ستنشئ Google موردًا لمؤسّسة في Google Cloud. سيتم منح كل المشرفين في حسابك الإداري على 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/v18/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 Ads API.

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

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

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

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

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

3. أنشأت Google مورد مؤسسة في Cloud نيابةً عنك:

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

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

لا يتوفّر هذا الاستخدام، لذا لن تتمكّن من المشاركة في هذا الإصدار التمهيدي.

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

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

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

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