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