يستخدم هذا الدليل مكتبة عميل لاسترداد حملات "إعلانات Google".
لتفعيل الوصول إلى واجهة برمجة التطبيقات، عليك أولاً الحصول على بيانات اعتماد OAuth2 المطلوبة.
بعد ذلك، أضف التفويض وتفاصيل الحساب إلى ملف تهيئة. بعد إعداد ملف التهيئة، تكون مستعدًا لاستدعاء واجهة برمجة التطبيقات.
معلمات التهيئة لمكتبة العميل
قدم المعلومات التالية في ملف التهيئة بمكتبة العميل.
- الرمز المميز للمطوِّر
يسمح الرمز المميز للمطوِّر لتطبيقك بالوصول إلى واجهة برمجة التطبيقات، لكن الرمز لا يقتصر على حساب واحد فقط في إعلانات Google. بعد الموافقة على رمزك المميز، يمكنك استخدام نفس الرمز المميز للطلبات المقدمة من جميع حساباتك في إعلانات Google، حتى إذا لم تكن مرتبطة بالحساب الإداري في إعلانات Google المرتبط بالرمز المميز.
يتم تفويض الحسابات التي تديرها عن طريق بيانات اعتماد OAuth من الحساب الإداري. يتطلب حساب المدير مجموعة واحدة فقط من بيانات الاعتماد لإدارة جميع حساباته الفرعية.
لا يمكن ربط سوى الرموز المميزة المعتمدة بواجهة برمجة التطبيقات لحسابات إعلانات الإنتاج في إعلانات Google، ويمكن ربط الرموز المميزة المعلقة بالحسابات التجريبية فقط.
يمكنك استرداد الرمز المميز للمطوِّر من خلال تسجيل الدخول إلى حسابك الإداري، ثم الانتقال إلى مركز واجهة برمجة التطبيقات (الأدوات والإعدادات > الإعداد > مركز واجهة برمجة التطبيقات).
- الرقم التعريفي للعميل/الزبون
الرقم التعريفي لعميل العميل هو رقم حساب عميل "إعلانات Google" الذي تريد إدارته باستخدام واجهة برمجة التطبيقات، وعادةً ما يكون في شكل
123-456-7890.
اختياريًا، يمكن ترك الرقم التعريفي لعميل العميل خارج ملف الضبط وضبطه برمجيًا. بعد الموافقة على الرمز المميز للمطوِّر، يمكنك استخدام الرقم التعريفي للعميل من حساب الإنتاج بدلاً من الحساب التجريبي.
- معرّف عميل OAuth2 وسر العميل
يربط معرّف عميل OAuth2 وسر العميل تطبيق العميل بمشروع في وحدة تحكم واجهة برمجة تطبيقات Google ويتم استخدامهما لمصادقة OAuth2 - مما يمكّن تطبيقك من العمل نيابة عن حسابك. فهي تحدد تطبيقك لـ Google وتسمح لك بإنشاء رموز OAuth مميزة لإدارة مستخدمي إعلانات Google. انظر إنشاء مُعرّف عميل وسر العميل لمزيد من التفاصيل.
- الرموز المميزة لإعادة تحميل بروتوكول OAuth2 وتحديثه
قبل أن يتمكّن تطبيقك من الوصول إلى البيانات الخاصة باستخدام واجهة برمجة التطبيقات، يجب أن يحصل التطبيق على رمز دخول مميز عبر OAuth2 يمنح إمكانية الوصول إلى واجهة برمجة التطبيقات.
إذا كنت تستخدم مكتبات العميل، فسيتم الاعتناء برمز الدخول المميز لبروتوكول OAuth2 تلقائيًا بالنيابة عنك. أو جرّب الحصول على رموز مميزة عبر مساحة بروتوكول OAuth.
تنتهي صلاحية رموز الدخول عبر OAuth2 بعد فترة زمنية محدودة. لهذا السبب، تستخدم مكتبات البرامج الرمز المميز لإعادة تحميل OAuth2 لإعادة إنشاء رمز الدخول المميز لبروتوكول OAuth2 تلقائيًا. يتضمن الدخول وإعادة تحميل الرمز المميز إرشادات لإنشاء الرمز المميز للتحديث.