การแมป JSON

เมื่อใช้อินเทอร์เฟซ 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"
          }
        }
      },
      ...
    ]
  }
]