این بخش برای کاربران پیشرفته ای در نظر گرفته شده است که قبلاً با مشخصات OAuth 2.0 آشنا هستند و می دانند چگونه از OAuth 2.0 با API های Google استفاده کنند .
دامنه
یک نشانه دسترسی واحد می تواند درجات مختلفی از دسترسی را به چندین API بدهد. پارامتر متغیری به نام 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، رمز دسترسی را از طریق Authorization سرصفحه HTTP عبور دهید. یک نمونه درخواست 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}" \