مستويات الوصول والاستخدام المسموح به

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

مستويات الوصول

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

مستوى الوصول يمكنه الوصول إلى... الحد الأقصى للعمليات اليومية 1 كيفية تقديم الطلب كم تستغرق المراجعات عادةً؟
اختبار حسابات الاختبار ‫15,000 عملية في اليوم تقديم طلب للحصول على إذن بالوصول إلى الإصدار التجريبي
المستكشف حسابات الاختبار وحسابات الإنتاج ‫2,880 عملية في اليوم لحسابات الإنتاج
15,000 عملية في اليوم للحسابات التجريبية		 تقديم طلب للحصول على إذن بالوصول إلى Explorer
التذكرة الأساسية حسابات الاختبار وحسابات الإنتاج ‫15,000 عملية في اليوم لكل من الحسابات التجريبية وحسابات الإنتاج تقديم طلب للحصول على إذن بالوصول الأساسي
خطة "الرزمة العادية" حسابات الاختبار وحسابات الإنتاج عمليات غير محدودة في اليوم لكلّ من حسابات الاختبار والإنتاج تقديم طلب للحصول على إذن بالوصول العادي 10 أيام عمل

1 يستند "في اليوم" إلى فترة زمنية متغيرة مدتها 24 ساعة تم خلالها إرسال طلبات إلى واجهة برمجة التطبيقات باستخدام مشروعك على Google Cloud. سيظهر خطأ في تطبيقك إذا تجاوز الحد الأقصى لعدد الطلبات المسموح به لمستوى الوصول الخاص بك خلال آخر 24 ساعة.

إمكانية الوصول إلى الاختبار

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

تقديم طلب للحصول على إذن بالوصول إلى الإصدار التجريبي

فعِّل Google Ads API في مشروعك على Google Cloud للحصول تلقائيًا على إذن الوصول إلى الإصدار التجريبي من مشروعك.

مستوى الوصول "المستكشف"

بعد إكمال عملية الاشتراك الأوّلية في Google Ads API، قد تسمح لك Google بتقديم طلب للحصول على مستوى الوصول "مستكشف".

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

يتيح مستوى الوصول "المستكشف" لمشروعك على Google Cloud تنفيذ ما يصل إلى 2,880 عملية يوميًا على حسابات الإنتاج. وهذا يكفي معظم المطوّرين للبدء باستخدام واجهة برمجة التطبيقات وإنشاء عمليات تشغيل آلي أساسية.

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

وظائف محدودة الخدمات والطرق المحظورة
إنشاء حساب CustomerService.CreateCustomerClient
إدارة المستخدمين CustomerUserAccessInvitationService
CustomerUserAccessService
التخطيط KeywordPlanService
KeywordPlanIdeaService
KeywordPlanCampaignService
KeywordPlanCampaignKeywordService
KeywordPlanAdGroupService
KeywordPlanAdGroupKeywordService
AudienceInsightsService
ReachPlanService
الفوترة والدفع في الحساب PaymentsAccountService
BillingSetupService
AccountBudgetProposalService
InvoiceService

تقديم طلب للحصول على مستوى الوصول "مستكشف"

  1. انتقِل إلى صفحة "نظرة عامة على Google Ads API" في مشروعك على Google Cloud.
  2. تأكَّد من أنّ الصفحة تعرض مستوى الوصول الحالي على أنّه اختبار.
  3. انقر لتوسيع قسم ترقية مستوى الوصول.
  4. تأكَّد من أنّ مستوى الوصول التالي معروض على أنّه مستكشف.
  5. انقر على الزر طلب الحصول على إذن الوصول لطلب الحصول على مستوى الوصول "مستكشف".

قد ترقّي Google تلقائيًا مستوى الوصول إلى واجهة برمجة التطبيقات في مشروعك إلى Explorer بعد إرسال طلبك.

مستوى الوصول الأساسي

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

يتيح مستوى الوصول الأساسي لمشروع Google Cloud تنفيذ ما يصل إلى 15,000 عملية في اليوم. وهذا يكفي لمعظم المطوّرين.

تقديم طلب للحصول على مستوى الوصول الأساسي

  1. انتقِل إلى صفحة "نظرة عامة على Google Ads API" في مشروعك على Google Cloud.
  2. تأكَّد من أنّ الصفحة تعرض مستوى الوصول الحالي على أنّه مستكشف.
  3. انقر لتوسيع قسم ترقية مستوى الوصول.
  4. تأكَّد من أنّ مستوى الوصول التالي معروض على أنّه أساسي.
  5. تأكَّد من عدم ظهور أي تحذيرات تشير إلى أنّك لم تُكمل عملية إثبات ملكية علامتك التجارية لمشروعك. إذا كانت هناك طلبات معلّقة، اتّبِع التعليمات لإكمال عملية تأكيد العلامة التجارية قبل المتابعة.
  6. انقر على الزر تقديم طلب للحصول على الإذن بالوصول لتقديم طلب للحصول على مستوى الوصول الأساسي.

قد ترقّي Google تلقائيًا مستوى الوصول إلى واجهة برمجة التطبيقات في مشروعك إلى "أساسي" بعد إرسال طلبك.

مستوى الوصول العادي

يتيح مستوى الوصول العادي لمشروعك على Google Cloud تنفيذ عدد غير محدود من العمليات يوميًا لجميع الخدمات. قد تظل بعض الخدمات والميزات الفردية تخضع لقيود على المعدّل وقيود أخرى خاصة بهذه الميزات، وستبقى هذه القيود سارية حتى إذا كان مشروعك يتضمّن مستوى الوصول "عادي".

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

تقديم طلب للحصول على إذن بالوصول العادي

  1. انتقِل إلى صفحة "نظرة عامة على Google Ads API" في مشروعك على Google Cloud.
  2. تأكَّد من أنّ الصفحة تعرض مستوى الوصول الحالي على أنّه أساسي.
  3. انقر لتوسيع قسم ترقية مستوى الوصول.
  4. تأكَّد من أنّ مستوى الوصول التالي معروض على أنّه عادي.
  5. انقر على الزر بدء التطبيق لبدء تطبيق مستوى الوصول العادي.

يتضمّن طلب الحصول على إذن الوصول العادي إجراء تدقيق يدوي مفصّل لتطبيقك. استعِد للإجابة عن أسئلة حول وظائف أداتك والجمهور المستهدف. إذا كان المستخدمون الخارجيون يستخدمون أداتك، عليك الاستعداد لتوفير إذن بالوصول إلى الحساب التجريبي إلى أداتك. يُرجى العِلم أنّ أداتك يجب أن تتوافق مع الحد الأدنى المطلوب من الوظائف.

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

حصص واجهة برمجة التطبيقات وحدود معدّل الطلبات في النظام

بغض النظر عن مستوى الوصول، تخضع جميع عمليات واجهة برمجة التطبيقات لحدود معدل النظام، ما يقيّد عدد العمليات التي يمكنك تنفيذها خلال فترة زمنية معيّنة، أي عدد العمليات في الساعة. لمزيد من المعلومات حول كيفية التعامل مع أخطاء الحد الأقصى لعدد الطلبات، يُرجى الاطّلاع على أنواع الأخطاء.

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

الاستخدام المسموح به

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

الاستخدام المسموح به الوصف
إنشاء الإعلانات وإدارتها توفير إمكانية الوصول إلى جميع خدمات واجهة برمجة التطبيقات لإنشاء وإدارة الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية على "إعلانات Google"
إعداد التقارير يجب إجراء طلبات GoogleAdsService.Search أو GoogleAdsService.SearchStream فقط، أو طلبات للقراءة فقط. هذا الخيار مخصّص للمطوّرين الذين يستخدمون واجهة برمجة التطبيقات لطلب الإحصاءات فقط.
البحث عن الكلمات الرئيسية والاقتراحات اسمح لمشروع Google Cloud بالوصول إلى RecommendationService وKeywordPlanIdeaService وKeywordPlanService. يتم استخدامها فقط من خلال الأدوات التي تتطلّب اقتراحات للمساعدة في تسهيل إنشاء حملات "إعلانات Google" وإدارتها.

تغيير الاستخدام المسموح به

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

السابق
الرمز المميز للمطوِّر
التالي
طلب تأكيد معلومات العلامة التجارية