注意:您正在查看 API 的 REST 介面說明文件。我們的官方用戶端程式庫支援 gRPC。詳情請參閱
REST 簡介。
JSON 對應
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
使用 Google Ads API 的 REST 介面時,需使用 JSON
表示與 Google Ads API
.proto 描述元檔案。JSON 編碼配置會遵循
「標準編碼配置」中
通訊協定的「JSON Mapping」區段
緩衝區語言指南。
一般而言,所有頂層郵件的收發作業
services 是單一 JSON 物件。
大部分 變更 要求包含的 operations
陣列,本身也包含多個
create
、update
或 delete
作業。同樣地,search
回應
包含 results
陣列與查詢結果集的 JSON 物件。
ID 會從 snake_case (通訊協定緩衝區中) 轉換為
JSON 中的 lowerCamelCase。這項規則有一個需要注意的地方
search
或 searchStream
可傳送 Google Ads 查詢語言
舉個簡單的例子,您可以定義情境
並指示 AI 如何回應服務中心查詢無論查詢語言為何,查詢語言本身都會使用蛇形
介面不過,REST 中的查詢結果會以
一般 JSON 物件,而這些物件的 ID 格式為 smallCamelCase。
例如,為了擷取帳戶中有效關鍵字清單的查詢,所執行的查詢會使用
查詢本身包含蛇形大小寫 (ad_group_criterion
,而非 adGroupCriterion
):
POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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
),且使用駝峰式大小寫 ID
改為使用 adGroupCriterion
:
[
{
"results": [
{
"adGroupCriterion": {
"resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060",
"keyword": {
"text": "pay per click"
}
}
},
...
]
}
]
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-22 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-08-22 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-08-22 (世界標準時間)。"]]