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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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