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

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

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

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

مستوى الوصول	يمكنه الوصول إلى...	الحد الأقصى اليومي للعمليات^1	كيفية تقديم الطلب	كم تستغرق المراجعات عادةً؟
مستوى الوصول إلى الحساب التجريبي	حسابات الاختبار	‫15,000 عملية في اليوم	التعليمات
مستوى الوصول "المستكشف"	حسابات الاختبار وحسابات الإنتاج	‫2,880 عملية في اليوم للحسابات النشطة ‫15,000 عملية في اليوم للحسابات التجريبية	التعليمات
مستوى الوصول الأساسي	حسابات الاختبار وحسابات الإنتاج	‫15,000 عملية في اليوم لكل من الحسابات التجريبية وحسابات الإنتاج	التعليمات	‫5 أيام عمل
مستوى الوصول العادي	حسابات الاختبار وحسابات الإنتاج	عمليات غير محدودة في اليوم لكلّ من حسابات الاختبار والإنتاج	التعليمات	10 أيام عمل

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

مستوى الوصول إلى الحساب التجريبي

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

ملاحظة مهمة: يُرجى الرجوع إلى دليل الحساب التجريبي لمعرفة المزيد حول كيفية إنشاء حساب تجريبي.

كيفية التقدّم بطلب للحصول على مستوى الوصول إلى حساب الاختبار

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

مستوى الوصول "المستكشف"

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

يتيح مستوى الوصول "مستكشف" للرمز المميز للمطوِّر تنفيذ ما يصل إلى 2,880 عملية في اليوم على حسابات الإنتاج، وهو عدد كافٍ لمعظم المطوِّرين لبدء استخدام واجهة برمجة التطبيقات وإنشاء عمليات أساسية للتشغيل الآلي.

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

وظائف محدودة	الخدمات والطرق المحظورة
إنشاء حساب	CustomerService.CreateCustomerClient
إدارة المستخدمين	CustomerUserAccessInvitationService CustomerUserAccessService
التخطيط	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService KeywordPlanIdeaService ReachPlanService
الفوترة والدفع في الحساب	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

كيفية تقديم طلب للحصول على مستوى الوصول "مستكشف"

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

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

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

يسمح مستوى الوصول الأساسي للرمز المميز للمطوِّر بتنفيذ ما يصل إلى 15,000 عملية في اليوم، وهو عدد كافٍ لمعظم المطوّرين.

كيفية تقديم طلب للحصول على مستوى الوصول الأساسي

إذا كان لديك رمز مميز للمطوِّر بمستوى الوصول إلى الحسابات الاختبارية أو إذن الوصول إلى الإصدار التجريبي، يمكنك تقديم طلب للحصول على إذن الوصول الأساسي باتّباع الخطوات التالية:

1. انتقِل إلى https://ads.google.com/aw/apicenter في متصفّح الويب. سجِّل الدخول إلى حسابك الإداري على "إعلانات Google" إذا طُلب منك ذلك.

   الوصول إلى "مركز واجهات برمجة التطبيقات"

2. تأكَّد من أنّ مستوى الوصول هو حساب اختبار أو مستكشف.

3. تأكَّد من أنّ عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات في مركز واجهة برمجة التطبيقات محدّث، إذ لن تتمكّن من إكمال عملية تقديم الطلب بدون عنوان بريد إلكتروني صالح يتم التحقّق منه بانتظام. تأكَّد من ربط جميع حساباتك النشطة على "إعلانات Google" بالحساب الإداري على "إعلانات Google" باستخدام الرمز المميز لواجهة برمجة التطبيقات.

4. انقر على سهم القائمة المنسدلة بجانب مستوى الوصول، ثم انقر على الرابط طلب الوصول الأساسي.

إكمال عملية إثبات ملكية العلامة التجارية لمشاريع Google Cloud

ملاحظة: عملية إثبات ملكية العلامة التجارية هي إجراء اختياري ويتم استخدامها فقط كإشارة لتحديد أهلية الوصول الأساسي إلى Ads API بشكل أسرع. لا تحتاج إلى إكمال عملية إثبات ملكية العلامة التجارية إذا كان لديك رمز مميّز للمطوّر تمت الموافقة عليه ولم تكن بصدد تقديم طلب جديد للحصول على مستوى الوصول الأساسي.

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

مستوى الوصول العادي

يتيح مستوى الوصول العادي للرمز المميز للمطوِّر تنفيذ عدد غير محدود من العمليات يوميًا لمعظم الخدمات، بما في ذلك GoogleAdsService Search وSearchStream على سبيل المثال لا الحصر. لمزيد من التفاصيل حول الحدود والاستثناءات لمستوى الوصول العادي، يُرجى الاطّلاع على حصص واجهة برمجة التطبيقات.

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

كيفية تقديم طلب للحصول على مستوى الوصول العادي

إذا كان لديك رمز مميز للمطوّر بمستوى الوصول الأساسي، يمكنك تقديم طلب للحصول على مستوى الوصول العادي باتّباع الخطوات التالية:

1. انتقِل إلى https://ads.google.com/aw/apicenter في متصفّح الويب. سجِّل الدخول إلى حسابك الإداري على "إعلانات Google" إذا طُلب منك ذلك.

   الوصول إلى "مركز واجهات برمجة التطبيقات"

2. تأكَّد من أنّ مستوى الوصول هو أساسي.

3. تأكَّد من أنّ عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات في مركز واجهة برمجة التطبيقات محدّث، إذ لن تتمكّن من إكمال عملية تقديم الطلب بدون عنوان بريد إلكتروني صالح يتم التحقّق منه بانتظام. تأكَّد من ربط جميع حساباتك النشطة على "إعلانات Google" بالحساب الإداري على "إعلانات Google" باستخدام الرمز المميز لواجهة برمجة التطبيقات.

4. انقر على سهم القائمة المنسدلة بجانب مستوى الوصول، ثم انقر على الرابط طلب الحصول على إذن بالوصول العادي.

إذا كان المستخدمون الخارجيون يستخدمون أداتك، عليك الاستعداد لتوفير إمكانية تسجيل الدخول التجريبي إلى أداتك. يُرجى العِلم أنّ أداتك يجب أن تتوافق مع الحد الأدنى المطلوب من الوظائف.

حصص واجهة برمجة التطبيقات وحدود معدّل الطلبات في النظام

بغض النظر عن مستوى الوصول، تخضع جميع عمليات واجهة برمجة التطبيقات لحدود معدّل النظام، ما يقيّد عدد العمليات التي يمكنك تنفيذها خلال فترة زمنية معيّنة، أي عدد العمليات في الساعة. لمعرفة المزيد حول كيفية التعامل مع أخطاء حدود المعدّل، راجِع أنواع الأخطاء.

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

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

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

الاستخدام المسموح به	الوصف
إنشاء الإعلانات وإدارتها	توفير إمكانية الوصول إلى جميع خدمات واجهة برمجة التطبيقات لإنشاء وإدارة الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية على "إعلانات Google"
إعداد التقارير	يجب إجراء طلبات GoogleAdsService.Search أو GoogleAdsService.SearchStream أو طلبات للقراءة فقط، وهذا مخصّص للمطوّرين الذين يستخدمون واجهة برمجة التطبيقات لطلب الإحصاءات فقط.
البحث عن الكلمات الرئيسية والاقتراحات	السماح للرمز المميّز للمطوّر بالوصول إلى RecommendationService وKeywordPlanIdeaService وKeywordPlanService، ويتم استخدام ذلك فقط من خلال الأدوات التي تتطلّب اقتراحات للمساعدة في تسهيل إنشاء حملات "إعلانات Google" وإدارتها.

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

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