این بخش برای کاربران پیشرفته‌ای درنظر گرفته شده است که ازقبل با مشخصات 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 تنظیم کرده باشید. می‌توانید اطلاعات بیشتر را در
راهنمای 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}" \