Method: advertisers.adGroups.list

string (int64 format)

必要欄位。廣告群組所屬廣告主的 ID。

integer

選用設定。請求的頁面大小。必須介於 1 至 200 之間。如果未指定，則預設為 100。如果指定無效值，則會傳回錯誤代碼 INVALID_ARGUMENT。

string

選用設定。這個符記可識別伺服器應傳回的結果頁面。通常，這是先前對 adGroups.list 方法的呼叫傳回的 nextPageToken 值。如未指定，系統會傳回第一頁的結果。

string

選用設定。用來排序清單的欄位。可接受的值如下：

• displayName (預設)
• entityStatus

預設排序順序為遞增。如要針對欄位指定遞減順序，則應於欄位名稱後方加上「desc」後置字串。範例：displayName desc。

string

選用設定。可依據自訂廣告群組欄位進行篩選。

支援的語法：

• 篩選器運算式由一或多個限制組成。
• 限制條件可透過 AND 和 OR 組合。一系列限制會隱含使用 AND。
• 限制的格式為 {field} {operator} {value}。
• 所有欄位都必須使用 EQUALS (=) 運算子。

支援的房源：

• adGroupId
• displayName
• entityStatus
• lineItemId
• adGroupFormat

範例：

• 委刊項「lineItemId="1234"」下的所有廣告群組
• 廣告主「(entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND adGroupFormat="AD_GROUP_FORMAT_IN_STREAM"」下的所有 ENTITY_STATUS_ACTIVE 或 ENTITY_STATUS_PAUSED AD_GROUP_FORMAT_IN_STREAM 廣告群組：

這個欄位的長度不得超過 500 個半形字元。

詳情請參閱篩選 LIST 要求指南。