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

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

نقطة أساسية: هل تريد بدء استخدام Google Ads API؟ تم إيقاف الرموز المميّزة للمطوّرين نهائيًا في 9 سبتمبر 2026، وتتم الآن إدارة مستويات الوصول إلى واجهة برمجة التطبيقات لكل مشروع على Google Cloud. بعد تفعيل Google Ads API (التي تمنح مستوى الوصول اختبار)، يمكنك على الفور تقديم طلب في صفحة "نظرة عامة" في Google Ads API ضمن Google Cloud Console للحصول على مستوى الوصول "مستكشف" (تتم المراجعة المبرمَجة والموافقة تلقائيًا في معظم الحالات، لما يصل إلى 2,880 عملية في اليوم على حسابات الإنتاج). للاطّلاع على خطوات الإعداد الكاملة، يُرجى مراجعة دليل البدء السريع لإجراء طلبك الأول أو دليل خادم MCP في "إعلانات Google".

الانتقال إلى صفحة "نظرة عامة" في Google Ads API ضمن Cloud Console

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

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

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

^‫1 يستند "يوميًا" إلى فترة زمنية متغيّرة تبلغ 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 تلقائيًا مستوى وصول مشروعك إلى واجهة برمجة التطبيقات إلى Explorer بعد إرسال طلبك.

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

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