يتمّ تحديد مستوى الوصول و "الاستخدام المسموح به" لكلّ رمز مميّز للمطوّر في Google Ads API. يحدّد مستوى الوصول ما إذا كان بإمكانك التأثير في حسابات الإنتاج وعدد العمليات والطلبات التي يمكنك تنفيذها يوميًا. تحدّد حالات الاستخدام المسموح بها ميزات Google Ads API المحدّدة التي يمكن للرمز المميز للمطوّر استخدامها.
مستويات الوصول
تتوفّر أربعة مستويات وصول مختلفة للرمز المميز للمطوِّر، وهي مدرَجة بالترتيب في الجدول. إذا لم يكن لديك إذن الوصول إلى Google Ads API، يمكنك البدء بالاشتراك للحصول على رمز مميز للمطوِّر بمستوى الوصول إلى حساب الاختبار. يمكنك رفع مستوى الوصول من خلال إكمال بعض الخطوات الإضافية في التطبيق.
| مستوى الوصول | يمكنه الوصول إلى... | الحد اليومي للعمليات1 | كيفية تقديم الطلب | كم تستغرق المراجعات عادةً؟ |
|---|---|---|---|---|
| مستوى الوصول إلى الحساب التجريبي | حسابات الاختبار | 15,000 عملية في اليوم | التعليمات | |
| مستوى الوصول "المستكشف" | حسابات الاختبار وحسابات الإنتاج | 2,880 عملية في اليوم للحسابات النشطة 15,000 عملية في اليوم للحسابات التجريبية |
التعليمات | |
| مستوى الوصول الأساسي | حسابات الاختبار وحسابات الإنتاج | 15,000 عملية في اليوم لكل من الحسابات التجريبية وحسابات الإنتاج | التعليمات | يوما عمل |
| مستوى الوصول العادي | حسابات الاختبار وحسابات الإنتاج | عمليات غير محدودة في اليوم لكلّ من حسابات الاختبار والإنتاج | التعليمات | 10 أيام عمل |
1 يستند "في اليوم" إلى فترة زمنية متغيرة مدتها 24 ساعة تم فيها تقديم طلبات إلى واجهة برمجة التطبيقات باستخدام الرمز المميز للمطوِّر. سيتلقّى تطبيقك رسالة خطأ إذا تجاوز الحدّ الأقصى لعدد الطلبات المسموح به لمستوى الوصول الخاص بك خلال آخر 24 ساعة.
مستوى الوصول إلى الحساب التجريبي
بعد إكمال عملية الاشتراك الأوّلية في Google Ads API، سيتم إصدار رمز مميز للمطوِّر لك بمستوى الوصول إلى الحسابات الاختبارية. وهذا يعني أنّ الرمز المميز للمطوِّر يمكنه فقط تقديم طلبات إلى Google Ads API مقابل حسابات تجريبية.
كيفية التقدّم بطلب للحصول على مستوى الوصول إلى حساب الاختبار
أكمِل عملية الاشتراك في Google Ads API على واجهة الويب الخاصة بـ "إعلانات Google" للحصول تلقائيًا على مستوى إذن الوصول إلى حساب الاختبار.
مستوى الوصول "المستكشف"
بعد إكمال عملية الاشتراك الأولية في Google Ads API، قد ترقّي Google تلقائيًا الرمز المميز للمطوِّر من مستوى الوصول إلى الحسابات الاختبارية إلى مستوى الوصول إلى "مستكشف" في بعض الحالات. يتيح مستوى الوصول "مستكشف" للرمز المميز للمطوِّر إمكانية إرسال طلبات إلى Google Ads API مقابل كلّ من الحسابات الاختبارية وحسابات الإنتاج. حسابات الإنتاج هي أي حسابات تعرض إعلانات Google حقيقية ومباشرة، بينما لا تعرض الحسابات التجريبية أي إعلانات.
يتيح مستوى الوصول "مستكشف" للرمز المميز للمطوِّر تنفيذ ما يصل إلى 2,880 عملية في اليوم على حسابات الإنتاج. وهذا يكفي معظم المطوّرين لبدء استخدام واجهة برمجة التطبيقات وإنشاء عمليات تشغيل آلي أساسية.
يقيّد مستوى الوصول "مستكشف" الوصول إلى الميزات التالية. إذا كنت بحاجة إلى استخدام هذه الميزات، عليك تقديم طلب للحصول على مستوى الوصول الأساسي أو مستوى الوصول العادي.
| وظائف محدودة | الخدمات والطرق المحظورة |
|---|---|
| إنشاء حساب | CustomerService.CreateCustomerClient |
| إدارة المستخدمين | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| التخطيط |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| الفوترة والدفع في الحساب |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
كيفية تقديم طلب للحصول على مستوى الوصول "مستكشف"
أكمِل عملية الاشتراك في Google Ads API على واجهة "إعلانات Google" على الويب. في بعض الحالات، قد ترقّي Google تلقائيًا الرمز المميز للمطوِّر إلى مستوى الوصول Explorer Access بعد إكمال عملية الاشتراك.
مستوى الوصول الأساسي
يتيح مستوى الوصول الأساسي للرمز المميز للمطوِّر إرسال طلبات إلى Google Ads API مقابل كلّ من الحسابات الاختبارية وحسابات الإنتاج. حسابات الإنتاج هي أي حسابات تعرض إعلانات Google حقيقية ومباشرة، بينما لا تعرض الحسابات التجريبية أي إعلانات.
يسمح مستوى الوصول الأساسي للرمز المميز للمطوِّر بتنفيذ ما يصل إلى 15,000 عملية في اليوم. وهذا يكفي لمعظم المطوّرين.
كيفية تقديم طلب للحصول على مستوى الوصول الأساسي
إذا كان لديك رمز مميز للمطوِّر بمستوى الوصول إلى الحسابات الاختبارية أو إذن الوصول إلى Explorer، يمكنك تقديم طلب للحصول على إذن الوصول الأساسي باتّباع الخطوات التالية:
انتقِل إلى https://ads.google.com/aw/apicenter في متصفّح الويب. سجِّل الدخول إلى حسابك الإداري على "إعلانات Google" إذا طُلب منك ذلك.
تأكَّد من أنّ مستوى الوصول هو حساب اختبار أو مستكشف.
تأكَّد من أنّ عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات في مركز API محدَّث. لن تتمكّن من إكمال عملية تقديم الطلب بدون عنوان بريد إلكتروني صالح يتم التحقّق منه بانتظام. تأكَّد من ربط جميع حساباتك النشطة على "إعلانات Google" بحسابك الإداري على "إعلانات Google" باستخدام الرمز المميز لواجهة برمجة التطبيقات.
انقر على سهم القائمة المنسدلة بجانب مستوى الوصول، ثم انقر على الرابط طلب الوصول الأساسي.
مستوى الوصول العادي
يتيح مستوى الوصول العادي لرمز المطوِّر المميز تنفيذ عدد غير محدود من العمليات يوميًا لمعظم الخدمات. ويشمل ذلك على سبيل المثال لا الحصر
GoogleAdsService Search و
SearchStream. لمزيد من التفاصيل حول الحدود والاستثناءات لمستوى الوصول العادي، يُرجى الاطّلاع على حصص واجهة برمجة التطبيقات.
لا يتم منح مستوى الوصول العادي إلا للمطوّرين الذين يحتاجون إلى عمليات غير محدودة في Google Ads API، مثل الشركات الكبيرة أو الأدوات التي تخدم العديد من المستخدمين.
كيفية تقديم طلب للحصول على مستوى الوصول العادي
إذا كان لديك رمز مميز للمطوِّر بمستوى الوصول الأساسي، يمكنك تقديم طلب للحصول على مستوى الوصول العادي باتّباع الخطوات التالية:
انتقِل إلى https://ads.google.com/aw/apicenter في متصفّح الويب. سجِّل الدخول إلى حسابك الإداري على "إعلانات Google" إذا طُلب منك ذلك.
تأكَّد من أنّ مستوى الوصول هو أساسي.
تأكَّد من أنّ عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات في مركز API محدَّث. لن تتمكّن من إكمال عملية تقديم الطلب بدون عنوان بريد إلكتروني صالح يتم التحقّق منه بانتظام. تأكَّد من ربط جميع حساباتك النشطة على "إعلانات Google" بحسابك الإداري على "إعلانات Google" باستخدام الرمز المميز لواجهة برمجة التطبيقات.
انقر على سهم القائمة المنسدلة بجانب مستوى الوصول، ثم انقر على الرابط طلب الوصول العادي.
إذا كان المستخدمون الخارجيون يستخدمون أداتك، عليك الاستعداد لتوفير إذن الوصول إلى الأداة من خلال حساب تجريبي. يُرجى العِلم أنّ أداتك يجب أن تتوافق مع الحد الأدنى المطلوب من الوظائف.
حصص واجهة برمجة التطبيقات وحدود معدّل الطلبات في النظام
بغض النظر عن مستوى الوصول، تخضع جميع عمليات واجهة برمجة التطبيقات لحدود معدل النظام، ما يفرض قيودًا على عدد العمليات التي يمكنك تنفيذها خلال فترة زمنية معيّنة، أي عدد العمليات في الساعة. لمزيد من المعلومات حول كيفية التعامل مع أخطاء الحد الأقصى لعدد الطلبات، يُرجى الاطّلاع على أنواع الأخطاء.
قد تفرض الخدمات الفردية قيودًا إضافية على الحصص بسبب أسباب مثل القيود المتعلقة بتصميم المنتج، والقيود المتعلقة بسياسة المنتج، واعتبارات الأداء ووقت الاستجابة لواجهة برمجة التطبيقات. لمزيد من المعلومات حول هذه القيود، يمكنك الاطّلاع على المستندات حول حصص واجهة برمجة التطبيقات.
الاستخدام المسموح به
لا ينطبق الاستخدام المسموح به إلا على الرموز المميزة للمطوّرين التي لديها مستويات الوصول الأساسي والعادي. يتم تحديد الاستخدام المسموح به استنادًا إلى الاستخدام المقصود من Google Ads API. تحدّد هذه الأذونات الميزات التي يمكن استخدام الرمز المميز للمطوِّر فيها، كما هو موضّح في الجدول التالي:
| الاستخدام المسموح به | الوصف |
|---|---|
| إنشاء الإعلانات وإدارتها | توفير إمكانية الوصول إلى جميع خدمات واجهة برمجة التطبيقات لإنشاء وإدارة الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية على "إعلانات Google" |
| إعداد التقارير | يجب إجراء طلبات GoogleAdsService.Search
أو GoogleAdsService.SearchStream
أو مكالمات للقراءة فقط. هذا الخيار مخصّص للمطوّرين الذين يستخدمون واجهة برمجة التطبيقات فقط لطلب الإحصاءات.
|
| البحث عن الكلمات الرئيسية والاقتراحات | السماح للرمز المميز للمطوِّر بالوصول إلى RecommendationService وKeywordPlanIdeaService وKeywordPlanService
ولا تُستخدَم هذه البيانات إلا من خلال الأدوات التي تتطلّب اقتراحات للمساعدة في تسهيل إنشاء حملات على "إعلانات Google" وإدارتها.
|
كيفية تغيير الاستخدام المسموح به
إذا تمت الموافقة على الرمز المميز للمطوِّر للحصول على إذن بالوصول الأساسي أو إذن بالوصول العادي، يمكنك ملء طلب تعديل الاستخدام المسموح به. يُرجى ملء نموذج الطلب إذا كنت تريد تعديل الاستخدام المسموح به أو منح عملائك إذن الوصول إلى أداتك.