ويتم تخصيص مستوى وصول و "استخدام مسموح به" لكل رمز مميز لمطوّر Google Ads API. يحدِّد مستوى الوصول ما إذا كان بإمكانك التأثير في حسابات الإنتاج وعدد العمليات والطلبات التي يمكنك تنفيذها يوميًا. يحدِّد الاستخدام المسموح به ميزات Google Ads API المحدّدة التي يُسمح للرمز المميّز للمطوِّر باستخدامها.
مستويات الوصول
هناك ثلاثة مستويات وصول مختلفة مدرجة بالترتيب في الجدول. إذا لم تكن تملك حق الوصول إلى Google Ads API، يمكنك البدء من خلال الاشتراك للحصول على إذن بالوصول إلى الحساب التجريبي. يمكنك زيادة مستوى الوصول من خلال إكمال بعض الخطوات الإضافية في التطبيق.
| مستوى الوصول | يمكن الوصول... | حد العمليات اليومية1 | تطبيق |
|---|---|---|---|
| اختبار الوصول إلى الحساب | اختبار الحسابات | 15,000 عملية / اليوم | التعليمات |
| الوصول الأساسي | حسابات الاختبار والإنتاج | 15,000 عملية / اليوم | التعليمات |
| الإذن بالوصول العادي | حسابات الاختبار والإنتاج | عمليات غير محدودة في اليوم | التعليمات |
1 يستند مقياس "في اليوم" إلى انخفاض عدد 24 ساعة في الفترة الزمنية التي تم فيها تقديم طلبات واجهة برمجة التطبيقات باستخدام الرمز المميز للمطوِّر. سيتلقّى تطبيقك رسالة خطأ إذا تجاوز الحدّ الأقصى للطلب لمستوى الوصول خلال آخر 24 ساعة.
اختبار الوصول إلى الحساب
بعد إكمال عملية الاشتراك الأولية في Google Ads API، يتم إصدار رمز مميز للمطوِّر يتضمن مستوى الوصول إلى الحساب التجريبي. وهذا يعني أنّ الرمز المميز للمطوِّر يمكنه فقط تقديم طلبات 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" وإدارتها. |
تغيير الاستخدام المسموح به
إذا تمت الموافقة على حصولك على مستوى الوصول الأساسي أو الوصول العادي، يمكنك ملء طلب تحديث الاستخدام المسموح به. يُرجى ملء الطلب إذا أردت تعديل الاستخدام المسموح به أو منح عملائك إمكانية الوصول إلى أداتك.