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

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

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

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

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

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

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

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

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

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

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

يتيح "الوصول الأساسي" للرمز المميّز للمطوِّر إمكانية تقديم طلبات واجهة برمجة التطبيقات مع "إعلانات Google" على كلّ من الحسابات الاختبارية وحسابات الإنتاج. حسابات الإنتاج هي أي حسابات تعرض إعلانات 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" وإدارتها.

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

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