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

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

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

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

مستوى الوصول يمكن الوصول إلى... حد التشغيل اليومي1 تطبيق
اختبار الوصول إلى الحساب حسابات تجريبية 15000 عملية / اليوم التعليمات
الوصول الأساسي حسابات الاختبار والإنتاج 15000 عملية / اليوم التعليمات
الإذن بالوصول العادي حسابات الاختبار والإنتاج عمليات غير محدودة / اليوم التعليمات

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

اختبار الوصول إلى الحساب

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

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

أكمِل الاشتراك في Google Ads API على واجهة "إعلانات Google" على الويب ليتمّ تلقائيًا منحك مستوى الوصول إلى الحساب التجريبي.

الوصول الأساسي

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

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

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

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

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

الإذن بالوصول العادي

يسمح الوصول العادي للرمز المميز للمطوِّر بتنفيذ عدد غير محدود من العمليات يوميًا لمعظم الخدمات. ويشمل ذلك على سبيل المثال لا الحصر GoogleAdsService Search و SearchStream. لمزيد من التفاصيل حول الحدود واستثناءات الوصول العادي، يرجى الاطّلاع على حصص واجهات برمجة التطبيقات.

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

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

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

إذا كان لديك حاليًا مستوى وصول أساسي وتريد تقديم طلب للحصول على عمليات غير محدودة في Google Ads API، يُرجى ملء نموذج طلب الوصول العادي.

إذا كانت أداتك خارجية، فكن مستعدًا لتوفير إذن تسجيل الدخول التجريبي إلى أداتك. تجدر الإشارة إلى أنّ أداتك يجب أن تلتزم بالحد الأدنى المطلوب من الوظائف.

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

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

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

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

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