البدء السريع

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

ضبط الإعدادات لمكتبة العميل

قدِّم المعلومات التالية في ملف الإعداد ضمن مكتبة العميل.

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

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

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

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

يمكنك استرداد الرمز المميّز لمطوّر البرامج من خلال تسجيل الدخول إلى حسابك الإداري، ثم الانتقال إلى مركز واجهة برمجة التطبيقات (الأدوات وamp؛ الإعدادات &gt؛ الإعداد وgt؛ مركز واجهة برمجة التطبيقات).

الرقم التعريفي للعميل/الزبون

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

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

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

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

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

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

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

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