本指南將詳細說明建立及更新最高成效廣告活動時，要求結構化資料的許多複雜問題。這份資源可在您設計整合時提供協助。本指南說明如何處理會變更最高成效廣告活動的請求，並可與最高成效廣告活動疑難排解指南和最高成效廣告活動批次處理指南搭配使用。
建立最高成效廣告活動
在 Google Ads API 中，最高成效廣告活動實體會以多個獨特資源的組合表示。
標準最高成效廣告活動
標準最高成效廣告活動需要至少一組資源才能放送。
如果廣告活動已啟用品牌規範，則建立 Campaign 的作業和必要的 CampaignAsset 資源必須包含在單一要求中，且 CampaignAsset 資源必須符合素材資源最低規定和規格。
請注意，建立 AssetGroup 和 AssetGroupAsset 實體的作業必須同時包含在單一要求中，且 AssetGroupAsset 資源必須結合以符合所有最低素材資源需求和規格。請參閱 Retail 廣告活動的差異。如果您在未提供所有必要 AssetGroupAsset 實體的情況下，提出建立 AssetGroup 的要求，系統會傳回錯誤。如需更多資訊，請參閱「無效狀態與無效要求」。
您可以透過多種方式建立最高成效廣告活動的結構化要求。如何將作業分組及建立要求結構，取決於您的目標和基礎架構。
- 請先在個別要求中建立
CampaignBudget、Campaign、Asset和CampaignAsset資源，再建立AssetGroup和AssetGroupAsset資源。(如果廣告活動已啟用品牌宣傳指南，則Campaign和必要的CampaignAsset資源必須一併納入單一要求) - 在單一變異要求中加入所有這些資源。
雖然您可以透過個別先前要求成功建立 CampaignBudget、Campaign、Asset 和 CampaignAsset 資源，但您必須先建立 AssetGroup 和 AssetGroupAsset 資源，最高成效廣告活動才有資格放送。
有效放送最高成效廣告活動的最低規定
如圖所示，您可以建立其他資源，進一步自訂最高成效廣告活動。
您可以在建立 AssetGroup 和 AssetGroupAsset 資源的相同要求中，加入建立 AssetGroupSignal 資源的作業。或者，您也可以在建立 AssetGroup 後，在個別要求中建立 AssetGroupSignal 實體。
包含額外選項的最高成效廣告活動
零售業專用最高成效廣告活動
零售廣告活動的特別之處在於，您可以透過兩種不同的方式建立素材資源群組，進而建立有效的放送廣告活動：
- 沒有任何素材資源的素材資源群組
- 包含所有必要素材資源的素材資源群組 (建議做法)
當您選擇從素材資源群組中排除素材資源時，Google 會自動使用已連結 Merchant Center 帳戶中提供的素材資源來建立廣告。不過，我們建議您提供素材資源，以便觸及所有廣告空間。零售業的最高成效廣告活動必須提供下列資源，才能放送廣告。
CampaignBudgetCampaign(已填入ShoppingSettings)AssetGroupAssetGroupListingGroupFilter
請注意，零售廣告活動必須填入 Campaign.shopping_settings 欄位。此外，每個 AssetGroup 中列出的 final_urls 必須與 Campaign.shopping_settings 中指定的 Merchant Center 帳戶 ID 相關聯的網址相符。最後，每個 AssetGroup 都必須有相關聯且有效的產品資訊群組樹狀結構，由一或多個 AssetGroupListingGroupFilter 資源組成。至少必須建立一個節點樹狀結構，才能處理指定 Merchant Center 動態饋給中的所有產品。
您可以個別建立這些資源，也可以在單一要求中建立。不過，您必須先正確建立所有這些資源，廣告活動才有資格放送。
有效放送的零售業最高成效廣告活動最低規定
零售廣告活動可使用標準最高成效廣告活動可用的所有選項，包括建立素材資源群組信號、廣告活動轉換目標和廣告活動條件。如果您在建立 AssetGroup 資源時選擇將資產加入 AssetGroup，則 AssetGroup 須遵守最低資產需求。換句話說，您可以不納入任何素材資源，也可以納入所有必要的素材資源。
零售業專用最高成效廣告活動，含額外選項
無效狀態與無效要求
在 Google Ads API 中使用最高成效廣告活動時，無效的狀態和無效的要求之間存在重要差異。
- 州/省錯誤
- 廣告活動的設定方式不符合放送資格。舉例來說，您可以使用
PERFORMANCE_MAX的advertising_channel_type建立獨立的Campaign資源。雖然建立廣告活動的要求已成功，但您必須先為廣告活動加入至少一個AssetGroup，廣告活動才符合放送資格。如果您的要求成功，但廣告活動或素材資源群組未放送，您可以使用CampaignPrimaryStatus、CampaignPrimaryStatusReason、AssetGroupPrimaryStatus和AssetGroupPrimaryStatusReason來判斷原因，詳情請參閱疑難排解指南。 - 要求無效
- 要求會將廣告活動或資源置於無效狀態，因此無法成功。舉例來說，如果您嘗試為非零售廣告活動建立
AssetGroup，但未加入最低必要素材資源，Google Ads API 就會擲回錯誤。因此，您必須在同一項要求中加入AssetGroup及其AssetGroupAsset資源。這也表示所有AssetGroupAsset資源都必須符合特定field_type的正確規格，才能避免整個要求失敗。
使用變更要求將作業分組
最高成效廣告活動由多個資源組成，您可以選擇在個別要求或單一大量變更要求中建立這些個別資源。不過，如先前所述，標準最高成效廣告活動中的 AssetGroups 和相關 AssetGroupAssets 必須在單一原子要求中建立。
您必須先成功建立本指南中所述的所有必要資源，廣告活動才有資格放送。發出個別要求時，請在後續要求中使用參照資源的實際資源名稱。發出包含多個作業的大量變更要求時，請使用透過臨時 ID 形成的資源名稱。
作業順序
無論您是否使用大量變更要求建立最高成效廣告活動，都必須依序安排要求和作業，確保在建立資源前不會參照該資源。在大量變異要求的情況下，這表示要以這樣的方式排序作業，讓參照的資源列於參照這些資源的資源之前。
如果您選擇在建立 AssetGroup 及其 AssetGroupAsset 資源的大量變更要求中建立資產資源，所有 AssetOperations 應置於所有 AssetGroupAssetOperations 之前，如圖所示。
Google Ads 伺服器會將連續的 AssetGroupAssetOperations 批次一起處理，並評估 AssetGroup 是否符合該群組中最後一次作業的最低素材資源需求。如果您在要求中交替使用 AssetOperations 和 AssetGroupAssetOperations，API 伺服器會在第一次 AssetGroupAssetOperation 後評估最低素材資源需求，並傳回錯誤，而不會繼續執行要求中的其他作業。因此，要求中的素材資源都不會新增至您的 Google Ads 帳戶。此外，系統也不會建立 AssetGroup 或任何相關的 AssetGroupAsset 資源。
更新素材資源群組
建立有效的 AssetGroup 後，您就無法發出後續要求，否則會導致無效狀態，且不再符合最低資產需求。任何這類要求都會擲回錯誤。舉例來說，如果您建立的 AssetGroup 只有一個 MARKETING_IMAGE (最低要求)，則任何要求移除與該 MARKETING_IMAGE 相關聯的 AssetGroupAsset 都會傳回錯誤。
對於零售廣告活動中沒有任何相關素材資源的素材資源群組而言，這一點尤其重要。後續要求透過建立 AssetGroupAsset 資源，將資產新增至 AssetGroup，只有在要求符合所有資產需求時才會成功。換句話說，您無法逐步將素材資源新增至這些素材資源群組。