เมื่อใช้อินเทอร์เฟซ REST ของ Search Ads 360 Reporting API คุณจะใช้งานการแสดง JSON ของทรัพยากรและประเภทเดียวกันกับที่กำหนดไว้ในไฟล์ .protocol descriptor ของ Search Ads 360 Reporting API อยู่ รูปแบบการเข้ารหัส JSON เป็นไปตามรูปแบบการเข้ารหัส Canonical ที่อธิบายไว้ในส่วนการแมป JSON ของคู่มือภาษาของบัฟเฟอร์โปรโตคอล
โดยทั่วไปแล้ว ข้อความระดับบนสุดทั้งหมดที่รับส่งจากบริการจะเป็นออบเจ็กต์ JSON เดี่ยว คำตอบ search
คือออบเจ็กต์ JSON ที่มีอาร์เรย์ results
กับชุดผลลัพธ์ของคำค้นหาของคุณ
ตัวระบุจะเปลี่ยนจาก snake_case (ในบัฟเฟอร์โปรโตคอล) เป็น lowerCamelCase ใน JSON ข้อควรระวังอย่างหนึ่งสำหรับกฎนี้คือเมื่อใช้ search
หรือ searchStream
เพื่อส่งคําค้นหาภาษาในคำค้นหาของ Search Ads 360 ภาษาของข้อความค้นหาจะใช้ตัวพิมพ์ใหญ่-เล็ก โดยไม่คำนึงถึงอินเทอร์เฟซที่คุณใช้ อย่างไรก็ตาม ผลลัพธ์ของการค้นหาใน REST จะแสดงผลเป็นออบเจ็กต์ JSON ปกติและมีตัวระบุใน LowCamelCase
ตัวอย่างเช่น การค้นหาเพื่อดึงข้อมูลรายการคีย์เวิร์ดที่ใช้งานอยู่ในบัญชีจะใช้ตัวพิมพ์แบบงูภายในตัวคำค้นหาเอง (ad_group_criterion
ไม่ใช่ adGroupCriterion
) ดังนี้
POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "query": "SELECT ad_group_criterion.keyword.text FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
แต่การตอบสนองจะเป็นการแสดงออบเจ็กต์ JSON ของออบเจ็กต์ (รวมไว้ในอาร์เรย์ JSON เนื่องจากคําขอนี้ใช้ searchStream
) และใช้ตัวระบุ CamlCase adGroupCriterion
แทน
[ { "results": [ { "adGroupCriterion": { "resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060", "keyword": { "text": "pay per click" } } }, ... ] } ]