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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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