تهتم مكتبات العملاء تلقائيًا بالتفاصيل الموضّحة أدناه، لذا يُرجى مواصلة القراءة فقط إذا كنت مهتمًا بما يحدث في المشاهد غير المرئية، أو إذا كنت لا تستخدم إحدى مكتبات العملاء.
هذا القسم مخصّص للمستخدمين المتقدّمين الذين لديهم دراية بـ مواصفات OAuth 2.0 ويعرفون كيفية استخدام OAuth2 مع Google APIs.
هل تريد معرفة المزيد من المعلومات عن المصادقة في واجهة برمجة التطبيقات؟
مكتبة الفيديوهات: المصادقة والتفويض
النطاق
يمكن أن يمنح رمز دخول واجهة برمجة تطبيقات واحد درجات مختلفة من الوصول إلى واجهات برمجة تطبيقات متعددة. تتحكّم scope، وهي مَعلمة متغيّرة، في مجموعة الموارد والعمليات التي يسمح بها رمز المرور. أثناء طلب الحصول على رمز مميّز للوصول، يُرسِل تطبيقك قيمة واحدة أو أكثر في المَعلمة scope.
نطاق Google Ads API هو:
https://www.googleapis.com/auth/adwords
الوصول إلى المحتوى بلا إنترنت
من الشائع أن يطلب تطبيق عميل Google Ads API الوصول إلى البيانات بلا إنترنت. على سبيل المثال، قد يريد تطبيقك تنفيذ مهام مجمّعة عندما لا يكون المستخدم متصلاً بالإنترنت ويتصفّح موقعك الإلكتروني.
لطلب الوصول بلا إنترنت لنوع تطبيق ويب، تأكَّد من ضبط المَعلمة
access_type على offline. يمكنك العثور على معلومات إضافية في
دليل بروتوكول OAuth2 من Google.
بالنسبة إلى نوع تطبيق الكمبيوتر المكتبي، يكون الوصول بلا إنترنت مفعّلاً تلقائيًا، ولا تحتاج إلى طلبه صراحةً.
عناوين الطلبات
عناوين gRPC
عند استخدام واجهة برمجة التطبيقات gRPC API، يجب تضمين رمز الوصول في كل طلب. يمكنك ربط
Credential بChannel لاستخدامه في جميع الطلبات على تلك القناة. يمكنك
أيضًا إرسال بيانات اعتماد مخصّصة لكل مكالمة. يتضمّن دليل
تفويض gRPC المزيد من
التفاصيل حول التعامل مع التفويض.
عناوين REST
عند استخدام واجهة برمجة التطبيقات REST، عليك تمرير الرمز المميّز للوصول من خلال عنوان HTTP
Authorization. في ما يلي مثال على طلب HTTP:
GET /v19/customers/123456789 HTTP/2 Host: googleads.googleapis.com User-Agent: INSERT_USER_AGENT Accept: */* Authorization: Bearer INSERT_ACCESS_TOKEN developer-token: INSERT_DEVELOPER_TOKEN
رمز الدخول المميّز ورمز الإعادة
في معظم الحالات، عليك تخزين رمز إعادة التحميل بأمان لاستخدامه في المستقبل. للتعرّف على مزيد من المعلومات عن كيفية طلب الحصول على رمزَي الوصول وإعادة التنشيط، يُرجى الاطّلاع على الدليل المقابل لنوع تطبيقك:
انتهاء صلاحية الرمز المميّز لإعادة التحميل
لمزيد من التفاصيل حول انتهاء صلاحية الرمز المميّز لإعادة التحميل، يُرجى الرجوع إلى مستندات Google Identity Platform OAuth.
انتهاء صلاحية رمز الدخول
يكون لرمز الوصول وقت انتهاء صلاحية (استنادًا إلى قيمة
expires_in) بعد
مغادرته هذا الوقت، لم يعُد الرمز صالحًا. يمكنك استخدام الرمز المميّز لإعادة التحميل لإعادة تحميل
رمز دخول منتهي الصلاحية. بشكلٍ تلقائي، تؤدي مكتبات برامجنا إلى
إعادة تحميل رموز الوصول المنتهية الصلاحية.