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

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

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

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

مستوى الوصول	يمكن الوصول إلى...	الحدّ الأقصى للعمليات اليومية^1	كيفية تقديم الطلب	ما هي المدة التي تستغرقها المراجعات عادةً؟
مستوى وصول "الحساب الاختباري"	الحسابات الاختبارية	15,000 عملية في اليوم	التعليمات
مستوى وصول "المستكشف"	الحسابات الاختبارية وحسابات الإنتاج	2,880 عملية في اليوم لحسابات الإنتاج 15,000 عملية في اليوم للحسابات الاختبارية	التعليمات
مستوى الوصول الأساسي	الحسابات الاختبارية وحسابات الإنتاج	15,000 عملية في اليوم لكلٍّ من الحسابات الاختبارية وحسابات الإنتاج	التعليمات	يومان عمل
مستوى الوصول العادي	الحسابات الاختبارية وحسابات الإنتاج	عدد غير محدود من العمليات في اليوم لكلٍّ من الحسابات الاختبارية وحسابات الإنتاج	التعليمات	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" إذا طُلب منك ذلك.

   الوصول إلى مركز API

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

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

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

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

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

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

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

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

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

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

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

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

   الوصول إلى مركز API

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

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

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

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

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

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

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

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

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

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

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

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