變更及檢查物件

API 結構指南所述,Google Ads API 中的每個頂層資源都有對應的資源專屬服務,可支援:

  • 修改資源的執行個體
  • 擷取要檢查的單一執行個體執行個體

本指南將使用 CampaignService 來示範修改和檢查 Campaign 物件,但相同的概念也適用於所有其他資源類型的特定服務。

變更物件

每項資源類型的專屬服務都會有一個可接受 Δ 要求的 Δ 方法。此要求包含:

  • customerId
  • 一組作業
  • 回應內容類型設定,決定是否應在可變動後傳回可變動的資源或資源名稱。

舉例來說,CampaignServiceMutateCampaigns 方法可接受 MutateCampaignsRequest,其中包含以下項目:

  • customerId
  • CampaignOperation 物件的集合
  • response_content_type 欄位,表示偏好的回應類型。

作業套件

作業物件 (例如 CampaignOperation) 可設定您要對單一資源執行的動作,只要設定其 operation 欄位即可。這個欄位是其中一個欄位,由類型為資源類型的下列屬性組成:

create
建立新的資源執行個體。
update
更新資源,使其符合 update 屬性的屬性。 這個欄位設定後,您也必須設定作業的 update_mask,指示 Google Ads API 在更新作業期間修改哪些屬性。每個用戶端程式庫都具備可產生 update_mask 的公用程式或輔助方法,如用戶端程式庫所示。
remove
移除資源。

由於 operation 欄位是 oneof 欄位,因此您無法使用單一作業來修改多個物件。舉例來說,如要建立一個廣告活動並移除另一個廣告活動,請在要求中加入兩個 CampaignOperation 例項:一個已設定 create,另一組則設為 remove

批次作業

雖然單一作業只能建立、更新或移除單一資源,但單一 變更要求可包含多項作業。您應該將這些作業合併為單一 Δ 要求,而不是傳送每個含有單一作業的多個 Δ 要求。

舉例來說,假設您要建立 10 個廣告活動,則應傳送 單一MutateCampaignsRequest包含 10 個 CampaignOperation 物件。

變更回應

回應中傳回的內容取決於 Δ 要求的 response_content_type 中傳送的內容。例如,如果指定 MUTABLE_RESOURCEresponse 只會包含廣告活動中的可變動欄位。然後,您可以針對該資源物件進行後續的 IDE 追蹤,這樣就不必重新建構。

變更錯誤

只有當特定請求中的「所有」作業成功時,指定的 RFP 請求中的作業才會套用到 Google Ads 帳戶。請參閱常見錯誤指南,瞭解常見錯誤清單以及解決方法。

使用 get 檢查物件 (已淘汰)

除了變更物件之外,每項資源類型的專屬服務還具有 get 方法,可擷取單一資源的所有屬性。這個方法可接受只有 resource_name 屬性的 get 要求。

get 方法是 Google Ads API 提供的便利工具,可讓您輕鬆擷取單一物件的所有屬性。雖然這是學習 API 或檢查個別物件以用於偵錯或教育目的的絕佳工具,但您的應用程式不應使用 get 方法擷取物件以處理或回報。因此,請使用 GoogleAdsService,因為這樣系統只會擷取物件的特定屬性、支援擷取成效指標,以及允許透過大型結果集進行串流。如果您的應用程式提交了大量的取得要求,可能會遇到頻率限制。