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

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