هذا القسم مخصّص للمستخدمين المتقدّمين الذين يعرفون مواصفات OAuth 2.0 وكيفية استخدام OAuth 2.0 مع 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 API، مرِّر رمز الوصول من خلال عنوان HTTP Authorization. في ما يلي مثال على طلب HTTP:
# Returns the resource names of customers directly accessible by the user # authenticating the call. # # Variables: # API_VERSION, # DEVELOPER_TOKEN, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. # curl -f --request GET \ "https://googleads.googleapis.com/v${API_VERSION}/customers:listAccessibleCustomers" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \