این بخش برای کاربران پیشرفته‌ای است که ازقبل با مشخصات OAuth 2.0 آشنا هستند و می‌دانند چگونه از OAuth 2.0 با Google API استفاده کنند.
حوزه
یک کد دسترسی واحد می‌تواند سطوح مختلفی از دسترسی به چندین میانای برنامه‌سازی کاربردی را اعطا کند. پارامتر متغیری به‌نام scope مجموعه منابع و عملیاتی را که کد دسترسی اجازه می‌دهد کنترل می‌کند. درطول درخواست کد دسترسی، برنامه‌تان یک یا چند مقدار در پارامتر scope ارسال می‌کند.
دامنه Google Ads API عبارت است از:
https://www.googleapis.com/auth/adwords
دسترسی آفلاین و طول عمر کد دسترسی
معمولاً برنامه کارخواه Google Ads API درخواست دسترسی آفلاین می‌کند. برای مثال، ممکن است برنامه‌تان بخواهد وقتی کاربرتان به‌طور فیزیکی آنلاین نیست و وب‌سایتتان را مرور نمی‌کند، کارهای دسته‌ای را اجرا کند. کدهای دسترسی ۳۶۰۰ ثانیه (۱ ساعت) اعتبار دارند، پس‌از آن برنامه شما باید کد بازآوری را با کد دسترسی جدیدی مبادله کند.
برای درخواست دسترسی آفلاین برای نوع برنامه وب، مطمئن شوید که پارامتر
access_type را روی offline تنظیم کرده‌اید. می‌توانید اطلاعات بیشتر را در
راهنمای OAuth 2.0 در Google پیدا کنید.
برای نوع برنامه رایانه‌ای، دسترسی آفلاین به‌طور پیش‌فرض فعال است—نیازی نیست به‌طور صریح آن را درخواست کنید.
سرایندهای درخواست
همه درخواست‌ها به Google Ads API باید شامل کد دسترسی OAuth 2.0 در سرایند درخواست باشد. بخش‌های زیر نحوه ارسال این اطلاعات اعتباری را بااستفاده از gRPC و REST شرح می‌دهند.
سرایندهای gRPC
هنگام استفاده از gRPC API، کد دسترسی را در هر درخواست اضافه کنید. می‌توانید
Credential را به Channel متصل کنید تا برای همه درخواست‌ها در آن کانال استفاده شود. همچنین می‌توانید
برای هر تماس، اطلاعات کاربری سفارشی‌شده ارسال کنید. راهنمای
مجوز gRPC حاوی جزئیات بیشتری درباره رسیدگی به مجوز است.
سرصفحه‌های REST
هنگام استفاده از REST API، کد دسترسی را ازطریق سرایند HTTP
Authorization: Bearer <ACCESS_TOKEN> ارسال کنید. یک درخواست HTTP نمونه نشان داده شده است:
# Returns the resource names of customers directly accessible by the user
# authenticating the call.
#
# Variables:
# API_VERSION,
# 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 "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \