يتم منح كل رمز مميّز للمطوّر في Google Ads API مستوى وصول و "استخدام مسموح به". يحدّد مستوى الوصول ما إذا كان بإمكانك التأثير في حسابات الإصدار العلني وعدد العمليات والطلبات التي يمكنك تنفيذها يوميًا. يحدّد الاستخدام المسموح به ميزات Google Ads API المحدّدة التي يُسمح باستخدام الرمز المميّز للمطوّر فيها.
مستويات الوصول
هناك ثلاثة مستويات وصول مختلفة مُدرَجة بالترتيب في الجدول. إذا لم يكن لديك إذن الوصول إلى Google Ads API، يمكنك البدء من خلال الاشتراك للحصول على إذن الوصول إلى الحساب التجريبي. يمكنك زيادة مستوى الوصول من خلال إكمال بعض الخطوات الإضافية في التطبيق.
| مستوى الوصول | يمكن الوصول إلى... | الحدّ الأقصى لعدد العمليات اليومية1 | تطبيق |
|---|---|---|---|
| الوصول إلى الحساب التجريبي | الحسابات الاختبارية | 15,000 عملية في اليوم | التعليمات |
| الوصول الأساسي | الحسابات التجريبية والحسابات العلنية | 15,000 عملية في اليوم | التعليمات |
| إذن الوصول العادي | الحسابات التجريبية والحسابات العلنية | عمليات غير محدودة في اليوم | التعليمات |
1 يستند "في اليوم" إلى فترة زمنية متحركة تبلغ 24 ساعة تم خلالها إرسال طلبات برمجة تطبيقات باستخدام الرمز المميّز للمطوّر. سيتلقّى طلبك خطأً إذا تجاوز الحدّ الأقصى لطلبات مستوى الوصول خلال آخر 24 ساعة.
الوصول إلى الحساب التجريبي
بعد إكمال عملية الاشتراك الأولية لواجهة برمجة التطبيقات مع "إعلانات Google"، يتم منحك رمزًا مميزًا للمطوِّر يتضمّن مستوى الوصول إلى الحساب التجريبي. وهذا يعني أنّه لا يمكن لرمز المطوِّر إرسال طلبات إلى Google Ads API إلا للحسابات الاختبارية.
تقديم طلب للوصول إلى حساب الاختبار
أكمِل الاشتراك في Google Ads API على واجهة ويب "إعلانات Google" للحصول تلقائيًا على مستوى الوصول إلى الحساب التجريبي.
الوصول الأساسي
يسمح الإذن بالوصول الأساسي للرمز المميّز للمطوّر بتقديم طلبات إلى Google Ads API في كلٍّ من الحسابات الاختبارية وحسابات الإنتاج. الحسابات العلنية هي أي حسابات تعرض إعلانات Google حقيقية ومعروضة على الإنترنت، ولا تعرض الحسابات التجريبية إعلانات.
يسمح مستوى الوصول الأساسي لرمز مطوّر البرامج بتنفيذ ما يصل إلى 15,000 عملية في اليوم. وهذا كافٍ لمعظم المطوّرين.
تقديم طلب للحصول على إذن بالوصول الأساسي
إذا كان لديك رمز مميّز للمطوّر على مستوى الوصول إلى الحساب التجريبي وأردت تقديم طلب للحصول على إذن بالوصول إلى الحساب العلني، يُرجى ملء نموذج طلب الإذن بالوصول الأساسي. احرِص على تنفيذ الخطوات التالية:
- تأكَّد من أنّ لديك رمزًا مميّزًا للمطوّر يتضمّن مستوى إذن بالوصول إلى الحساب الاختباري.
- تأكَّد من أنّ عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات في مركز واجهة برمجة التطبيقات محدّث. يجب تسجيل دخولك إلى حسابك الإداري للاطّلاع على "مركز واجهة برمجة التطبيقات". لن تتمكّن من إكمال عملية تقديم الطلب بدون عنوان بريد إلكتروني صالح يتم التحقّق منه بانتظام. تأكَّد من ربط كل حساباتك النشطة على "إعلانات Google" بالحساب الإداري باستخدام الرمز المميّز لواجهة برمجة التطبيقات.
إذن الوصول العادي
يسمح إذن الوصول العادي لرمز مطوِّر البرامج بتنفيذ عدد غير محدود من
العمليات في اليوم لمعظم الخدمات. ويشمل ذلك على سبيل المثال لا الحصر
GoogleAdsService Search و
SearchStream. لمزيد من التفاصيل
حول الحدود والاستثناءات للوصول العادي، يُرجى الاطّلاع على
حصص واجهات برمجة التطبيقات.
لا يُمنح مستوى الوصول العادي إلّا للمطوّرين الذين يحتاجون إلى عمليات غير محدودة في Google Ads API، مثل الشركات الكبيرة أو الأدوات التي تخدم العديد من المستخدمين.
بغض النظر عن مستوى الوصول، تخضع جميع عمليات واجهة برمجة التطبيقات لمحدودية معدلات النظام. لمعرفة مزيد من المعلومات عن كيفية التعامل مع أخطاء الحدّ الأقصى للمعدل، اطّلِع على أنواع الأخطاء.
تقديم طلب للحصول على إذن بالوصول العادي
إذا كان لديك حاليًا مستوى وصول أساسي وأردت تقديم طلب للحصول على عمليات غير محدودة في Google Ads API، يُرجى ملء نموذج طلب الوصول العادي.
إذا كانت أداتك خارجية، عليك توفير إمكانية تسجيل الدخول إلى الإصدار التجريبي من أداتك. يُرجى العلم أنّ الأداة يجب أن تستوفي الحد الأدنى المطلوب من الوظائف.
الاستخدام المسموح به
لا ينطبق الاستخدام المسموح به إلا على رموز الوصول الأساسية ورموز الوصول العادية. يتم تخصيص الاستخدام المسموح به استنادًا إلى الاستخدام المقصود لواجهة Google Ads API. وتحدِّد هذه الأذونات ميزات واجهة برمجة التطبيقات التي يمكن استخدام الرمز المميّز لها، كما هو موضح بالتفصيل في الجدول التالي:
| الاستخدام المسموح به | الوصف |
|---|---|
| إنشاء الإعلانات أو إدارتها | توفير إمكانية الوصول إلى جميع خدمات واجهة برمجة التطبيقات لإنشاء وإدارة الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية على "إعلانات Google" |
| إعداد التقارير | يمكنك فقط إجراء طلبات GoogleAdsService.Search
أو GoogleAdsService.SearchStream
أو مكالمات للقراءة فقط. هذا الإجراء مخصّص للمطوّرين الذين يستخدمون واجهة برمجة التطبيقات فقط لطلب الإحصاءات.
|
| البحث عن الكلمات الرئيسية والاقتراحات | اسمح للرمز المميّز بالوصول إلى RecommendationService وKeywordPlanIdeaService وKeywordPlanService. لا يتم استخدام هذا الإجراء إلا من خلال الأدوات التي تتطلّب اقتراحات للمساعدة في تسهيل إنشاء حملات "إعلانات Google" وإدارتها. |
تغيير الاستخدام المسموح به
إذا تمت الموافقة على مستوى الوصول الأساسي أو مستوى الوصول العادي، يمكنك ملء طلب تعديل الاستخدام المسموح به. املأ الطلب إذا أردت تعديل الاستخدام المسموح به أو منح العميل إذن الوصول إلى أداتك.