Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google
searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว
รูปแบบใน Search Ads 360 Reporting API
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
รูปแบบคำขอจะขึ้นอยู่กับประเภทคำขอที่คุณส่ง
ค้นหา
คุณปรับแต่งเอาต์พุตการค้นหาได้โดยกำหนดข้อความค้นหาให้เหมาะกับความต้องการของคุณ ภาษาคําค้นหาของ Search Ads 360 ช่วยให้คุณค้นหาแหล่งข้อมูลทั้งหมดเพื่อหารายการเอนทิตีที่ตรงกับชุดเกณฑ์ที่เฉพาะเจาะจงได้ คำขอทั้งหมดไม่ว่าจะส่งไปยังเอนทิตีประเภทใดก็ตามจะส่งไปยัง SearchAds360Service ดูข้อมูลเพิ่มเติมที่หัวข้อสร้างรายงานการค้นหาและภาษาคําค้นหาของ Search Ads 360
ช่องที่ระบบป้อนข้อมูลในการตอบกลับจะขึ้นอยู่กับบริการที่คุณใช้
SearchAds360Service- การตอบกลับจะมีออบเจ็กต์
SearchAds360Row 1 รายการสำหรับเอนทิตีแต่ละรายการที่ตรงกับพารามิเตอร์การค้นหา แต่ละแถวมีออบเจ็กต์ 1 รายการ เช่น แคมเปญ และจะมีเฉพาะช่องที่คุณขอในคําค้นหา
- บริการที่เฉพาะเจาะจง
- คุณขอได้ครั้งละ 1 รายการตามชื่อทรัพยากร การตอบกลับจะรวมช่องทั้งหมดของเอนทิตีนั้น
ใน API ใหม่ คุณต้องระบุรหัสลูกค้าเป็นตัวเลข 10 หลัก (XXXXXXXXXX) โดยไม่มีขีดกลาง
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[[["\u003cp\u003eSearch Ads 360 API request formats vary depending on whether you're searching or requesting specific entities.\u003c/p\u003e\n"],["\u003cp\u003eSearches utilize the Search Ads 360 Query Language and the \u003ccode\u003eSearchAds360Service\u003c/code\u003e for customized results.\u003c/p\u003e\n"],["\u003cp\u003eResponses from \u003ccode\u003eSearchAds360Service\u003c/code\u003e include a \u003ccode\u003eSearchAds360Row\u003c/code\u003e for each matching entity, containing only the requested fields.\u003c/p\u003e\n"],["\u003cp\u003eRequests for specific entities return all fields for that entity, and customer IDs must be provided as 10-digit numbers without dashes.\u003c/p\u003e\n"]]],["Search requests utilize the Search Ads 360 Query Language against the `SearchAds360Service` to retrieve entities matching specific criteria. Responses from `SearchAds360Service` return `SearchAds360Row` objects, including only requested fields. Specific service requests retrieve one entity by resource name, returning all its fields. The Customer ID in the API must be a 10-digit number without dashes. The user can use the \"Create search reports\" or \"Search Ads 360 Query Language\" to learn more.\n"],null,["# Formats in the Search Ads 360 Reporting API\n\nRequest format\n--------------\n\nThe request format depends on the type of request you make.\n\n### Search\n\nYou can customize your search output by defining a search query\nto suit your needs. The Search Ads 360 Query Language allows you to search all\nresources for a list of entities that match a specific set of criteria. All\nrequests, regardless of the entity type, are made against the\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service). See [Create search reports](/search-ads/reporting/concepts/search-reports) and\n[Search Ads 360 Query Language](/search-ads/reporting/query/query-language)\nto learn more.\n\nResponse format\n---------------\n\nThe fields populated in the response depend on the service you use:\n\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service)\n: The response includes one [`SearchAds360Row`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360row) object for each entity that\n matches your search parameters. Each row contains one object, for example, a\n campaign, and includes *only* the fields you request in your query.\n\nSpecific services\n: You can only request one entity at a time by resource name. The response\n includes *all* fields for that entity.\n\nCustomer ID format\n------------------\n\nIn the new API, you must specify your Customer ID as a 10-digit number\n(`XXXXXXXXXX`) without dashes."]]
