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

يتم تعيين مستوى وصول و"استخدام مسموح به" لمشروعك على 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 على إذن الوصول "خطة الرزمة العادية"، يمكنك ملء الطلب لتعديل الاستخدام المسموح به. يُرجى ملء الطلب إذا كنت تريد تعديل الاستخدام المسموح به أو منح عملائك إذن الوصول إلى أداتك.