يسمح الرمز المميز للمطوِّر من Google لتطبيقك بالاتصال بواجهة برمجة التطبيقات مع "إعلانات Google". يتم تعيين مستوى وصول لكل رمز مميز للمطوِّر يتحكم في عدد طلبات البيانات من واجهة برمجة التطبيقات التي يمكنك إجراؤها يوميًا باستخدام الرمز المميز، بالإضافة إلى البيئة التي يمكنك إجراء استدعاءات لها. مزيد من المعلومات
يمكن ربط كل مشروع في وحدة تحكم Google API بالرمز المميز للمطوِّر من حساب إداري واحد فقط. بعد تقديم طلب إعلانات Google API، يتم إقران الرمز المميز للمطوِّر بشكل دائم بمشروع وحدة تحكم Google API.
في حالة التبديل إلى رمز مميز للمطوِّر ضمن حساب إداري جديد، ستحتاج أولاً إلى إنشاء مشروع وحدة تحكم Google API جديد لطلبات إعلانات Google API التي تستخدم الرمز المميز للمدير الجديد. إذا كنت لا تستخدم مشروعًا جديدًا لوحدة تحكم واجهة برمجة تطبيقات Google،
سيظهر لك خطأ DEVELOPER_TOKEN_PROHIBITED عند تقديم طلب.
الإجراء
الخطوة 1: اختيار حساب إداري على "إعلانات Google" أو إنشاؤه
يجب أن يكون لديك أولاً حساب إداري في إعلانات Google قبل التقدم بطلب للحصول على رمز مميز للمطوِّر.
لا يمكن إنشاء الحسابات الإدارية باستخدام عنوان البريد الإلكتروني نفسه المستخدَم في حساب "إعلانات Google" الحالي. ولذلك يجب استخدام عنوان بريد إلكتروني لم يتم ربطه من قبل بحساب إعلانات Google لإنشاء حساب المدير.
لاحظ أن الحساب الإداري الذي تختاره لا يؤثر في مجموعة حسابات "إعلانات Google" التي يمكن للرمز المميز للمطوِّر الوصول إليها. حيث يتم استخدامه فقط للاحتفاظ بالرمز المميز للمطوِّر.
يمكن للرمز المميز نفسه الدخول إلى أي حساب طالما أن لديك بيانات اعتماد OAuth صحيحة. ومع ذلك، سيؤدي ربط هذا الحساب الإداري إلى حسابات شركتك النشطة على "إعلانات Google" إلى تبسيط عملية مراجعة التطبيق وتقليل عدد المرات التي تحتاج إليها خلال عملية المصادقة لإدارة حساباتك باستخدام واجهة برمجة التطبيقات. للحصول على تفاصيل، اطلع على مقالة مركز المساعدة حول ربط الحسابات.
الخطوة 2: طلب الوصول إلى إعلانات Google API
اشترك للوصول إلى إعلانات Google API من خلال حسابك الإداري. سجّل الدخول، ثم انتقل إلى الأدوات والإعدادات > الإعداد > مركز واجهة برمجة التطبيقات. لا يظهر خيار مركز واجهة برمجة التطبيقات إلا للحسابات الإدارية على "إعلانات Google".
يجب إكمال جميع الحقول في نموذج الوصول إلى واجهة برمجة التطبيقات، ويتم قبول البنود والشروط. تأكد من صحة معلوماتك ومن عمل عنوان URL لموقع شركتك على الويب. إذا لم يكن موقع الويب صفحة مباشرة، فلن نتمكن من معالجة طلبك.
تأكد من أن البريد الإلكتروني لجهة اتصال واجهة برمجة التطبيقات الذي تقدمه يؤدي إلى صندوق بريد يخضع بانتظام للمراقبة. إذا لم نتمكن من الاتصال بك على عنوان البريد الإلكتروني هذا، فلن نتمكن من معالجة طلبك، وسيتم رفضه.
يمكنك تعديل البريد الإلكتروني لجهة اتصال واجهة برمجة التطبيقات في مركز واجهة برمجة التطبيقات.
ونحن نحثك بشدة على تحديث هذه المعلومات باستمرار، حتى بعد معالجة طلب الاشتراك، حتى نتمكن من إرسال إعلانات خدمة مهمة إليك.
الخطوة 3: متابعة طلبك
يجب الموافقة على الرمز المميز للمطوِّر في انتظار المراجعة قبل استخدامه مع حسابات الإنتاج في إعلانات Google. يمكنك التقدم بطلب للحصول على حق الوصول الأساسي أو حق الوصول العادي.
اطلب حق الوصول الأساسي إذا كان استخدام واجهة برمجة التطبيقات من المتوقع أن يكون ضئيلاً.
اطلب الوصول القياسي إذا كان استخدام واجهة برمجة التطبيقات من المتوقع أن يكون مرتفعًا.
راجع ورقة الأسعار لتحديد ما إذا كنت تحتاج إلى حق الوصول الأساسي أم الوصول القياسي. إذا لم تكن متأكدًا من استخدامك لواجهة برمجة التطبيقات في المستقبل، فإننا نوصي بالبدء باستخدام حق الوصول الأساسي والترقية إلى حق الوصول القياسي عندما يقترب استخدام واجهة برمجة التطبيقات لتطبيقك من تطبيق قيود الحصة المفروضة بواسطة الدخول الأساسي بشكل متكرر.
تتم مراجعة كلٍّ من تطبيقات حق الوصول الأساسي وحق الوصول العادي للتأكد من توافق الأداة أو التطبيق البرمجي الذي تقترح استخدامه مع إعلانات Google API مع البنود والشروط والسياسات، بما في ذلك الحد الأدنى المطلوب من الوظائف (RMF) (إن وجد). إذا كانت شركتك تدير حسابات "إعلانات Google" للعملاء، عليك الالتزام بسياسة الجهات الخارجية حتى تتمكّن من الوصول إلى "إعلانات Google API".
نتصل بك عادة في غضون يومي عمل من تاريخ إرسال طلبك، على عنوان البريد الإلكتروني الذي قدمته في الخطوة 2. إذا لم يعد بإمكانك الدخول إلى هذا البريد الوارد، أو إذا كنت لا تخطط لمراقبة عنوان البريد الإلكتروني هذا بنشاط، فعدّل عنوان البريد الإلكتروني في مركز واجهة برمجة التطبيقات عن طريق اتباع الإرشادات أعلاه في الخطوة 2، حتى نتمكن من الاتصال بك.
وافق فريق مراجعة الرموز المميزة على الرمز المميز للمطوِّر
سيتم تنشيط الرمز المميز للمطوِّر المعين لبيئة الإنتاج بعد الموافقة على طلبك للدخول إلى واجهة برمجة التطبيقات. سيكون رمزك المميز متاحًا من خلال مركز API - الذي يمكن الوصول إليه من خلال قائمة إعدادات الحساب - للحساب الإداري الذي تقدمت من خلاله. وستتمكن من الدخول إلى واجهة برمجة التطبيقات من خلال تضمينها في عناوين الطلب عند التفاعل مع النظام.
من المهم جدًا الحفاظ على تحديث عنوان بريدك الإلكتروني للاتصال، لأننا نرسل معلومات مهمة تتعلق بالتغييرات أو انقطاعات الخدمة إلى عنوان البريد الإلكتروني الذي تحدده.
إذا أجريت أي تغييرات على أداتك في المستقبل، يجب عليك إبلاغ Google عن هذه التغييرات عن طريق ملء نموذج تغيير أداة إعلانات Google API.
رفض فريق مراجعة الرموز المميّزة طلبي
يفحص فريق Token Review المعلومات التي تقدمها عند التقدم بطلب للوصول إلى إعلانات Google API للتأكد من التزام برنامجك ببنود وشروط إعلانات Google API (T&C) والحد الأدنى المطلوب من الوظائف (RMF) (إن وجد).
تتضمن الأسباب الشائعة لرفض تطبيق ما يلي:
- يتعذر علينا الوصول إليك على عنوان البريد الإلكتروني الذي قدمته للاتصال بك.
- لقد تقدمت بطلب لأن الأداة التي تستخدمها من جهة خارجية تتطلب الرمز المميز للمطوِّر.
- ينتهك طلبك أحكامًا أخرى في "الأحكام والشروط".
- لا ينفِّذ تطبيقك العناصر المطلوبة من "الحد الأدنى المطلوب من الوظائف" (إن أمكن).
إذا كنت قد غيّرت أداة API للالتزام بسياسة إعلانات Google API، أو إذا كنت تعتقد أن طلبك تم رفضه عن طريق الخطأ، يمكنك إعادة تقديم طلب الاشتراك عن طريق النقر على الرابط إعادة تقديم الطلب في صفحة "مركز واجهة برمجة التطبيقات" بحسابك الإداري.
إذا لم تتلق رسالة إلكترونية منا حول طلبك في غضون الوقت المتوقع، فاتصل بفريق الامتثال لسياسة إعلانات Google API.
الفوترة
لا توجد رسوم لاستخدام إعلانات Google API. ونحن نحصّل رسوم عدم الامتثال للالتزام بالحد الأدنى المطلوب من الوظائف. اطّلع على ورقة الأسعار لمزيد من التفاصيل.