คุณต้องมีทั้งข้อมูลเข้าสู่ระบบของแอปพลิเคชัน OAuth 2.0 และโทเค็น
นักพัฒนาซอฟต์แวร์เมื่อเรียกใช้ Google Ads API หากคุณทำการเรียก API
ด้วยบัญชีดูแลจัดการ Google Ads คุณจะต้องระบุlogin-customer-id
ส่วนหัวกับคำขอแต่ละรายการด้วย หน้านี้อธิบายวิธีตั้งค่าเหล่านี้และ
เอกสารส่วนหัว HTTP เพิ่มเติมที่เฉพาะเจาะจง API หลายรายการซึ่งส่งและ
รับเมื่อใช้ REST Interface
ข้อมูลเข้าสู่ระบบ OAuth 2.0
Google Ads API ใช้ข้อมูลเข้าสู่ระบบของแอปพลิเคชันเพื่อระบุและให้สิทธิ์คำขอ API ทั้งไคลเอ็นต์ OAuth 2.0 และบัญชีบริการสามารถกำหนดค่าได้ ดูรายละเอียดเพิ่มเติม เกี่ยวกับการกำหนดค่าการให้สิทธิ์ฝั่งไคลเอ็นต์ได้ที่ OAuth2 ใน Google Ads API
หากเพิ่งเริ่มใช้ Google APIs คุณสามารถใช้ oauth2l หรือ OAuth 2.0 Playground เพื่อทดลองใช้ข้อมูลเข้าสู่ระบบของแอปพลิเคชันและ Google Ads API ก่อนที่จะเขียนโค้ดสำหรับแอป
การใช้โฟลว์ของเดสก์ท็อปหรือเว็บแอป
ทำตามขั้นตอนเพื่อกำหนดค่าโปรเจ็กต์คอนโซล Google API สำหรับ Google Ads API บันทึกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ แล้วกลับมาที่หน้านี้
เมื่อสร้างไคลเอ็นต์ OAuth แล้ว ให้ทำตามวิธีการของโฟลว์แอปบนเดสก์ท็อปหรือวิธีการของโฟลว์เว็บแอปเพื่อ สร้างโทเค็นการรีเฟรชและโทเค็นเพื่อการเข้าถึง
การใช้บัญชีบริการ
ทำตามวิธีการทั่วไปในคู่มือบัญชีบริการ เพื่อตั้งค่าการเข้าถึงบัญชีบริการสำหรับ Google Ads API
เมื่อตั้งค่าบัญชีบริการเพื่อเข้าถึงบัญชี Google Ads แล้ว ให้ทําตามคําแนะนําการใช้ OAuth 2.0 สําหรับแอปพลิเคชันที่มีการโต้ตอบระหว่างเซิร์ฟเวอร์กับเซิร์ฟเวอร์
โดยตรวจสอบว่าได้เลือกแท็บ HTTP/REST แล้ว scopeที่จะใช้สำหรับการเข้าถึง Google Ads API
คือ https://www.googleapis.com/auth/adwords
การสร้างโทเค็นเพื่อการเข้าถึงใหม่
เมื่อมีรหัสไคลเอ็นต์ ข้อมูลลับไคลเอ็นต์ และโทเค็นการรีเฟรชแล้ว คุณจะ
สร้างโทเค็นเพื่อการเข้าถึงใหม่เพื่อใช้ในการเรียก API ด้วย
เครื่องมือบรรทัดคำสั่ง curl ได้
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/tokenจากนั้นคุณจะใช้โทเค็นเพื่อการเข้าถึงที่คำขอ curl ส่งกลับมาในส่วนหัว HTTP Authorization ของการเรียก API ทุกครั้งไปยัง Google Ads API ได้
GET /v21/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
ส่วนหัวของคำขอ
โทเค็นของนักพัฒนา
นอกจากนี้ Google Ads API ยังกำหนดให้ต้องมีโทเค็นของนักพัฒนาซอฟต์แวร์เพื่อทำการเรียกไปยัง API คุณสามารถสมัครรับโทเค็นสำหรับบัญชีดูแลจัดการได้โดยตรงจาก UI ของ Google Ads ดูรายละเอียดเพิ่มเติมเกี่ยวกับการตั้งค่าโทเค็นของนักพัฒนาซอฟต์แวร์ได้ที่ รับโทเค็นของนักพัฒนาซอฟต์แวร์
คุณต้องระบุค่าโทเค็นของนักพัฒนาในdeveloper-tokenส่วนหัว HTTP
ของการเรียกใช้ API ทุกครั้งไปยัง Google Ads API
GET /v21/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
รหัสลูกค้าสำหรับการเข้าสู่ระบบ
สำหรับการเรียก Google Ads API ที่ผู้ดูแลจัดการทําในบัญชีลูกค้า (กล่าวคือ เมื่อ
เข้าสู่ระบบในฐานะผู้ดูแลจัดการเพื่อทําการเรียก API ไปยังบัญชีลูกค้าบัญชีใดบัญชีหนึ่ง) คุณจะต้องระบุlogin-customer-idส่วนหัว HTTP ด้วย ค่านี้แสดง
รหัสลูกค้า Google Ads ของผู้จัดการที่ทำการเรียก API
การรวมส่วนหัวนี้เทียบเท่ากับการเลือกบัญชีใน UI ของ Google Ads
หลังจากลงชื่อเข้าใช้หรือคลิกรูปโปรไฟล์ที่มุมขวาบนของ
หน้าเว็บ เมื่อระบุรหัสลูกค้า โปรดนำขีดกลาง (—) ออก
เช่น 1234567890 ไม่ใช่ 123-456-7890
GET /v21/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
รหัสลูกค้าที่ลิงก์
ส่วนหัวนี้ใช้โดยผู้ให้บริการวิเคราะห์แอปบุคคลที่สามเท่านั้นเมื่อ อัปโหลด Conversion ไปยังบัญชี Google Ads ที่ลิงก์ไว้ ดูรายละเอียดเพิ่มเติมได้ที่ คู่มือโครงสร้างการเรียก API
...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID
ส่วนหัวการตอบกลับ
ระบบจะแสดงส่วนหัวต่อไปนี้ในการตอบกลับ HTTP จาก API
รหัสคำขอ
request-id เป็นสตริงที่ระบุคำขอ API โดยไม่ซ้ำกัน เมื่อ
แก้ไขข้อบกพร่องหรือแก้ปัญหาเกี่ยวกับการเรียก API ที่เฉพาะเจาะจง request-id
เป็นตัวระบุที่สำคัญซึ่งควรมีไว้พร้อมเมื่อติดต่อทีมสนับสนุนนักพัฒนาแอปของ Google
request-id: 2a5Cj89VV7CNhya1DZjjrC