البدء السريع

يستخدم هذا الدليل مكتبة العملاء لاسترداد حملات "إعلانات Google".

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

المتطلّبات الأساسية

معلمات الإعداد

يجب تقديم المعلومات التالية في ملف الإعداد الخاص بمكتبة العملاء.

الرمز المميز للمطوِّر

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

يمكن ربط الرموز المميزة الموافَق عليها فقط بواجهة برمجة التطبيقات لحسابات "إعلانات Google" الإنتاجية. أمّا الرموز المميزة المعلّقة، فيمكن ربطها بالحسابات التجريبية فقط.

يمكنك استرداد الرمز المميّز لمطوّر البرامج عن طريق تسجيل الدخول إلى حسابك الإداري ثم الانتقال إلى مركز واجهة برمجة التطبيقات (ToolS & settings > setup > API Center).

النقاط الرئيسية

  • يجب أن يتوفّر للشركة رمز مميز واحد فقط لمطوّر البرامج.
  • بعد استخدام معرِّف عميل من مشروع على Google Cloud مع رمز مميز لمطوّر برامج، يتم ربط معرِّف العميل بالرمز المميز لمطوّر البرامج ولا يمكن استخدامه مع رمز مميز آخر لمطوّر البرامج. بمعنى آخر:
    • يمكن استخدام رمز مميز للمطوِّر مع معرِّفات عملاء متعددة.
    • ومع ذلك، لا يمكن استخدام معرِّف العميل إلا مع رمز مميز واحد للمطوِّر.
الرقم التعريفي للعميل/الزبون

الرقم التعريفي لعميل العميل هو رقم حساب عميل "إعلانات Google" الذي تريد إدارته باستخدام واجهة برمجة التطبيقات، ويكون عادةً على النحو 123-456-7890.

اختياريًا، يمكن ترك الرقم التعريفي للعميل المتعلق بالعميل من ملف الإعداد وضبطه برمجيًا. بعد الموافقة على الرمز المميز للمطوِّر، يمكنك استخدام معرِّف عميل من حساب إنتاج بدلاً من حساب اختباري.

معرّف العميل وسر العميل OAuth2

يربط معرِّف عميل OAuth2 وسر العميل تطبيق العميل بمشروع في وحدة تحكم واجهة برمجة تطبيقات Google، ويتم استخدامهما لمصادقة OAuth2، ما يسمح لتطبيقك بالعمل نيابةً عن حسابك. وهي تحدد تطبيقك لـ Google وتسمح لك بإنشاء رموز OAuth المميزة لإدارة مستخدمي إعلانات Google.

يمكنك الرجوع إلى إنشاء معرّف عميل وسرّ العميل للحصول على مزيد من التفاصيل.

الرموز المميزة لإعادة التوجيه إلى OAuth2 وإعادة التحميل

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

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

تنتهي صلاحية رموز الدخول عبر OAuth2 بعد فترة محدودة. ولهذا السبب، تستخدم مكتبات البرامج رمز إعادة التحميل OAuth2 لإعادة إنشاء رمز الدخول OAuth2 تلقائيًا.

يتضمن الوصول عبر OAuth2 والرموز المميزة تعليمات حول إنشاء الرمز المميز لإعادة التحميل.

لمزيد من المعلومات حول استخدام بروتوكول OAuth2 مع واجهات برمجة تطبيقات Google، يُرجى الاطّلاع على وثائق OAuth2 المصادقة وOAuth2 Identity Platform.