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

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

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

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

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

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

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

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

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

تقديم طلب للحصول على مستوى وصول "الحساب التجريبي"

فعِّل Google Ads API في مشروعك على Google Cloud ليتم تلقائيًا منح مستوى وصول "الحساب التجريبي" لمشروعك.

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

بعد إكمال عملية الاشتراك الأولية في Google Ads API، قد تسمح لك Google بتقديم طلب للحصول على مستوى وصول "المستكشف".

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

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

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

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

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

1. انتقِل إلى صفحة "نظرة عامة على Google Ads API" في مشروعك على Google Cloud.
2. تأكَّد من أنّ الصفحة تعرض مستوى وصولك الحالي على أنّه تجريبي.
3. انقر لتوسيع قسم ترقية مستوى الوصول.
4. تأكَّد من أنّ مستوى الوصول التالي معروض على أنّه المستكشف.
5. انقر على الزر تقديم طلب للحصول على إذن الوصول لتقديم طلب للحصول على مستوى وصول "المستكشف".

قد ترقّي Google تلقائيًا مستوى وصول واجهة برمجة التطبيقات في مشروعك إلى مستوى وصول "المستكشف" بعد إرسال طلبك.

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

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

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

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

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

1. انتقِل إلى صفحة "نظرة عامة على Google Ads API" في مشروعك على Google Cloud.
2. تأكَّد من أنّ الصفحة تعرض مستوى وصولك الحالي على أنّه المستكشف.
3. انقر لتوسيع قسم ترقية مستوى الوصول.
4. تأكَّد من أنّ مستوى الوصول التالي معروض على أنّه أساسي.
5. تأكَّد من عدم ظهور أي تحذيرات تشير إلى أنّك لم تُكمل عملية إثبات ملكية العلامة التجارية لمشروعك. إذا ظهرت تحذيرات، اتّبِع التعليمات لإكمال عملية إثبات ملكية العلامة التجارية قبل المتابعة.
6. انقر على الزر تقديم طلب للحصول على إذن الوصول لتقديم طلب للحصول على مستوى الوصول الأساسي.

قد ترقّي Google تلقائيًا مستوى وصول واجهة برمجة التطبيقات في مشروعك إلى مستوى الوصول الأساسي بعد إرسال طلبك.

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

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

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

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

1. انتقِل إلى صفحة "نظرة عامة على Google Ads API" في مشروعك على Google Cloud.
2. تأكَّد من أنّ الصفحة تعرض مستوى وصولك الحالي على أنّه أساسي.
3. انقر لتوسيع قسم ترقية مستوى الوصول.
4. تأكَّد من أنّ مستوى الوصول التالي معروض على أنّه عادي.
5. انقر على الزر بدء الطلب لبدء طلب مستوى الوصول العادي.

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

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

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

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

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

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

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

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

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

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