Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว

หน้านี้ได้รับการแปลโดย Cloud Translation API

การให้สิทธิ์และส่วนหัว HTTP

คุณต้องมีข้อมูลเข้าสู่ระบบของแอปพลิเคชัน OAuth 2.0 เมื่อเรียกใช้ Search Ads 360 Reporting API หากคุณทําการเรียก API ในฐานะบัญชีดูแลจัดการ Search Ads 360 คุณจะต้องระบุส่วนหัว login-customer-id พร้อมกับคําขอแต่ละรายการด้วย หน้านี้จะอธิบายวิธีตั้งค่าเหล่านี้และเอกสาร ส่วนหัว HTTP เพิ่มเติมหลายรายการที่เฉพาะเจาะจง API ซึ่งจะมีการส่งและรับเมื่อ ใช้อินเทอร์เฟซ REST

ข้อมูลเข้าสู่ระบบ OAuth 2.0

Search Ads 360 Reporting API ใช้ข้อมูลเข้าสู่ระบบของแอปพลิเคชันเพื่อระบุและให้สิทธิ์คำขอ API กำหนดค่าไคลเอ็นต์ OAuth 2.0 ได้ การเรียก Search Ads 360 Reporting API ทั้งหมดต้องได้รับอนุญาตผ่าน OAuth2 OAuth2 ช่วยให้แอปไคลเอ็นต์ Search Ads 360 Reporting API เข้าถึงบัญชี Search Ads 360 ของผู้ใช้ได้โดยไม่ต้องจัดการหรือจัดเก็บข้อมูลการเข้าสู่ระบบของผู้ใช้

หากเพิ่งเริ่มใช้ Google APIs คุณสามารถใช้ oauth2l หรือ OAuth 2.0 Playground เพื่อทดลองใช้ข้อมูลเข้าสู่ระบบของแอปพลิเคชันและ Search Ads 360 Reporting API ก่อนที่จะเขียนโค้ดสำหรับแอปได้ นอกจากนี้ คุณยังสร้างโทเค็นการรีเฟรช OAuth ได้โดยการเรียกใช้สคริปต์การสร้างข้อมูลเข้าสู่ระบบของผู้ใช้ที่ให้ไว้

การสร้างโทเค็นเพื่อการเข้าถึงใหม่

เมื่อมีรหัสไคลเอ็นต์ ข้อมูลลับไคลเอ็นต์ และโทเค็นการรีเฟรชแล้ว คุณจะ สร้างโทเค็นเพื่อการเข้าถึงใหม่เพื่อใช้ในการเรียก 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 ส่งกลับมาใน Authorization ส่วนหัว HTTP ของการเรียก API ทุกครั้งไปยัง Search Ads 360 Reporting API ดังนี้

GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN

ส่วนหัวของคำขอ

รหัสลูกค้าสำหรับการเข้าสู่ระบบ

สําหรับการเรียกใช้ Search Ads 360 Reporting API ที่บัญชีดูแลจัดการทําในบัญชีลูกค้า (กล่าวคือ เมื่อ เข้าสู่ระบบในฐานะบัญชีดูแลจัดการเพื่อทําการเรียกใช้ API ในบัญชีลูกค้าบัญชีใดบัญชีหนึ่ง) คุณ ต้องระบุส่วนหัว HTTP login-customer-id ด้วย ค่านี้แสดงถึง รหัสลูกค้า Search Ads 360 ของผู้จัดการที่ทําการเรียก API

การรวมส่วนหัวนี้เทียบเท่ากับการเลือกบัญชีใน UI ของ Search Ads 360 หลังจากลงชื่อเข้าใช้หรือคลิกรูปโปรไฟล์ที่มุมขวาบนของ หน้า เมื่อระบุรหัสลูกค้า โปรดนำขีดกลาง (—) ออก เช่น 1234567890 ไม่ใช่ 123-456-7890

GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID

ส่วนหัวการตอบกลับ

ระบบจะแสดงส่วนหัวต่อไปนี้ในการตอบกลับ HTTP จาก API

รหัสคำขอ

request-id เป็นสตริงที่ระบุคำขอ API โดยไม่ซ้ำกัน เมื่อ แก้ไขข้อบกพร่องหรือแก้ปัญหาเกี่ยวกับการเรียก API ที่เฉพาะเจาะจง request-id เป็นตัวระบุที่สำคัญซึ่งควรมีไว้พร้อมเมื่อติดต่อทีมสนับสนุนนักพัฒนาแอปของ Google

request-id: 2a5Cj89VV7CNhya1DZjjrC