تعتني مكتبات العملاء تلقائيًا بالتفاصيل الواردة أدناه، فتابع القراءة فقط إذا كنت مهتمًا بما يحدث وراء المشاهد، أو إذا كنت لا تستخدم إحدى مكتبات العملاء لدينا.
هذا القسم مخصّص للمستخدمين المتقدّمين الذين لديهم دراية مسبقة مع مواصفات 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 /v17/customers/123456789 HTTP/2 Host: googleads.googleapis.com User-Agent: INSERT_USER_AGENT Accept: */* Authorization: Bearer INSERT_ACCESS_TOKEN developer-token: INSERT_DEVELOPER_TOKEN
الرمز المميّز للدخول وإعادة التحميل
وفي معظم الحالات، يجب تخزين الرمز المميز للتحديث بأمان لاستخدامه في المستقبل. لمعرفة المزيد من المعلومات حول كيفية طلب رموز الدخول وإعادة التحميل، يُرجى الاطّلاع على الدليل المناسب لنوع طلبك:
انتهاء صلاحية الرمز المميّز لإعادة التحميل
لمزيد من التفاصيل حول انتهاء صلاحية الرمز المميّز لإعادة التحميل، يُرجى الرجوع إلى صفحة مستندات OAuth في النظام الأساسي للهوية
انتهاء صلاحية رمز الدخول المميز
لرمز الدخول وقت انتهاء صلاحية (استنادًا إلى
expires_in) بعد
حيث لم يعد الرمز المميز صالحًا. يمكنك استخدام الرمز المميّز لإعادة التحميل
رمز دخول منتهي الصلاحية. تقوم مكتبات العملاء تلقائيًا
إعادة تحميل رموز الدخول المنتهية الصلاحية.