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

ملاحظة: تقبل Google مقدّمي الطلبات لهذا البرنامج. الاشتراك

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

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

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

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

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

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

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

• مؤسسة على Google Cloud

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

  السيناريو	الخطوات
  لديك حساب حالي في Google Workspace أو Google Cloud عميل هوي Google	من المحتمل أن يكون لديك بالفعل مورد مؤسسة. يمكنك الشيكات وإنشاء واحد إذا لزم الأمر.
  أنت لا تستخدم 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 عميل الهوية، من المحتمل أن تكون مشاريع وحدة تحكُّم Google API الموجودة بالفعل ضمن مؤسستك بحيث يمكنك تخطي هذه الخطوة.
  لا تملك مؤسسة على Google Cloud ولا يمكنك إنشاء مؤسسة فيها الخطوة السابقة	تأكّد من أنّك مستخدم مشرف في حساب مدير Google Ads API. لحسابك ومشروع وحدة التحكم في واجهة Google API. تحتاج إلى هذا الإذن من أجل إجراء خطوات إضافية بعد الموافقة على طلب المشاركة في البرنامج التجريبي.

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

  تأكّد من أن عنوان البريد الإلكتروني لجهة اتصال 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 واتّباع تعليمات نقل مشروع 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/v17/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" بدون أي رسوم، ولا تُجري 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، لذلك لن يتم تحصيل أي رسوم نتيجة لذلك.

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

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

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

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

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

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