يجب توفّر بيانات اعتماد تطبيق OAuth 2.0 ومطوّر برامج.
الرمز المميّز عند طلب Google Ads API. في حال إجراء طلبات بيانات من واجهة برمجة التطبيقات
باستخدام حساب إداري على "إعلانات Google"، يجب أيضًا تحديد login-customer-id
مع كل طلب. تصف هذه الصفحة كيفية تعيين هذه القيم
العديد من رؤوس HTTP الإضافية الخاصة بواجهة برمجة التطبيقات التي يتم إرسالها
تم استلامها عند استخدام واجهة REST.
بيانات اعتماد OAuth 2.0
تستخدم Google Ads API بيانات اعتماد التطبيق لتحديد واجهة برمجة التطبيقات وتفويضها. الطلبات. برامج OAuth 2.0 والخدمة الحسابات. لمزيد من التفاصيل حول تهيئة المصادقة من جهة العميل، راجع OAuth2 في قسم Google Ads API:
إذا كنت مستخدمًا جديدًا لـ Google APIs، يمكنك استخدام oauth2l أو OAuth 2.0 "مساحة المرح" لإجراء تجارب بيانات اعتماد التطبيق وGoogle Ads API قبل كتابة الرمز التطبيق.
استخدام تدفقات تطبيق الويب أو سطح المكتب
اتّبِع الخطوات لضبط مشروع وحدة تحكّم واجهة برمجة تطبيقات Google من أجل Google Ads API: سجِّل Client-ID (معرّف العميل) client secret، ثم الرجوع إلى هذه الصفحة.
بعد إنشاء عميل OAuth، يمكنك اتّباع مسار تطبيق أجهزة سطح المكتب. التعليمات أو تدفق تطبيق الويب التعليمات إنشاء رمز مميّز لإعادة التحميل ورمز دخول
استخدام حسابات الخدمة
اتّبِع التعليمات الشائعة في الخدمة. الحسابات دليل لإعداد أذونات الوصول إلى حساب الخدمة لخدمة Google Ads API.
بعد إعداد حساب الخدمة للوصول إلى حسابك على "إعلانات Google"، اتّبِع الخطوات التالية:
استخدام OAuth 2.0 من خادم إلى خادم
الطلبات
مع التأكد من تحديد علامة تبويب HTTP/REST. scope المطلوب استخدامها مع Google Ads API
إمكانية الوصول https://www.googleapis.com/auth/adwords.
إنشاء رموز دخول جديدة
بعد الحصول على معرّف عميل وسر العميل ورمز مميز لإعادة التحميل، يمكنك
إنشاء رمز دخول جديد لاستخدامه في طلبات البيانات من واجهة برمجة التطبيقات مع
أداة سطر أوامر curl:
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/token
ويمكنك بعد ذلك استخدام رمز الدخول الذي يعرضه طلب التجعّد في
Authorization عنوان HTTP لكل طلب بيانات من واجهة برمجة التطبيقات إلى Google Ads API:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
عناوين الطلبات
الرمز المميز للمطوِّر
تتطلب Google Ads API أيضًا رمزًا مميزًا للمطوِّر لإجراء طلبات واجهة برمجة التطبيقات. يمكنك تقديم طلب للحصول على رمز مميّز لحسابك الإداري مباشرةً من واجهة مستخدم "إعلانات Google" لمزيد من التفاصيل عن كيفية الإعداد باستخدام الرمز المميز للمطوِّر، يُرجى الاطّلاع على احصل على الرمز المميز للمطوِّر.
يجب تضمين قيمة الرمز المميّز للمطوِّر في بروتوكول HTTP developer-token.
عنوان كل طلب بيانات من واجهة برمجة التطبيقات إلى Google Ads API:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
الرقم التعريفي لتسجيل الدخول للعميل
بالنسبة إلى طلبات Google Ads API التي يجريها أحد المدراء لحساب عميل (أي عندما
تسجيل الدخول كمدير لإجراء طلبات بيانات من واجهة برمجة التطبيقات إلى أحد حسابات العملاء لديه)،
يجب أيضًا توفير عنوان HTTP يتضمّن العنصر login-customer-id. تمثل هذه القيمة
الرقم التعريفي لعميل "إعلانات Google" للمدير الذي يجري طلب البيانات من واجهة برمجة التطبيقات.
يتساوى تضمين هذا العنوان مع اختيار حساب في واجهة مستخدم "إعلانات Google".
بعد تسجيل الدخول أو النقر على صورة ملفك الشخصي في أعلى الجانب الأيسر من
الصفحة. عند تحديد الرقم التعريفي للعميل، احرص على إزالة أيّ واصلات (—) أو
على سبيل المثال: 1234567890، وليس 123-456-7890.
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
الرقم التعريفي للعميل المرتبط
لا يستخدم هذا العنوان إلا مقدمي خدمة تحليلات التطبيقات التابعين لجهات خارجية عند جارٍ تحميل الإحالات الناجحة إلى حساب مرتبط على "إعلانات Google" الحساب. يمكنك الاطّلاع على دليل بنية طلب البيانات من واجهة برمجة التطبيقات لمزيد من التفاصيل.
...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID
عناوين الردود
يتم عرض العناوين التالية في استجابات HTTP من واجهة برمجة التطبيقات.
معرّف الطلب
والسمة request-id هي سلسلة تعرِّف طلب البيانات من واجهة برمجة التطبيقات بشكل فريد. فعندما
تصحيح الأخطاء أو تحديد المشاكل وحلّها في طلبات بيانات معيّنة من واجهة برمجة التطبيقات، request-id
معرّف مهم يجب أن يكون في متناول يدك عند التواصل مع مطوّر برامج Google
والدعم.
request-id: 2a5Cj89VV7CNhya1DZjjrC