ส่วนนี้มีไว้สำหรับผู้ใช้ขั้นสูงที่คุ้นเคยกับข้อกำหนด OAuth 2.0 อยู่แล้วและทราบวิธีใช้ OAuth 2.0 กับ Google APIs
ขอบเขต
โทเค็นเพื่อการเข้าถึงรายการเดียวสามารถให้สิทธิ์การเข้าถึง API หลายรายการในระดับต่างๆ พารามิเตอร์ตัวแปรที่ชื่อ scope
ควบคุมชุดทรัพยากรและการดำเนินการ
ที่โทเค็นการเข้าถึงอนุญาต ในระหว่างคำขอโทเค็นเพื่อเข้าถึง แอปของคุณจะส่งค่าอย่างน้อย 1 ค่าในพารามิเตอร์ 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}" \