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

يتمّ تحديد مستوى الوصول و "الاستخدام المسموح به" لكلّ رمز مميّز للمطوّر في 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 تلقائيًا رمز المطوّر إلى مستوى Explorer Access بعد إكمال عملية الاشتراك.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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