共用方式為

AdGroupExcludedAudienceSelector

  • 發行項

包含篩選和排序廣告群組排除物件清單的方法。 如需選取器的相關資訊，請參閱 選取器。

範例使用方式：

    // Gets the iterator that iterates all ad group excluded audiences
    // in the account.
    var iterator = AdsApp.adGroups().get();

    // Loops through all ad groups in the account.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();

        // Gets the iterator that iterates all ad group excluded audiences
        // in the ad group excluded audience.
        var audienceIterator = adGroup.targeting().audiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all ad group excluded audiences in the ad group excluded audience.
        while (audienceIterator.hasNext()) {
            var audience = audienceIterator.next();
        }
    }

方法

方法名稱 傳回類型 說明
get AdGroupExcludedAudienceIterator 取得反覆運算器，用來逐一查看排除廣告群組的物件清單。
orderBy (字串 orderBy) AdGroupExcludedAudienceSelector 將指定的順序套用至選取的廣告群組排除物件。
withCondition (字串條件) AdGroupExcludedAudienceSelector 將篩選準則套用至廣告群組排除的物件。
withIds (string[] ids) AdGroupExcludedAudienceSelector 取得具有指定識別碼的廣告群組排除物件。
withLimit (int 限制) AdGroupExcludedAudienceSelector 取得符合選取準則的前 n 個廣告群組排除物件。

獲取

取得迭 代器 ，用來逐一查看排除廣告群組的物件清單。

傳回

類型 說明
AdGroupExcludedAudienceIterator 反覆運算器，用來逐一查看選取的廣告群組排除的物件。

orderBy (String orderBy)

將指定的順序套用至選取的廣告群組排除物件。

以 「columnName orderDirection」 格式指定 orderBy 參數，其中：

  • columnName 是其中一個 支援的資料行。
  • orderDirection 是排序結果的順序。 設定為 ASC，以遞增順序排序結果或 DESC，以遞減順序排序結果。 預設值為 ASC。

例如，下列呼叫會依 AverageCpc 以遞增順序傳回排除廣告群組的物件。

selector = selector.orderBy("AverageCpc");

選取器僅支援依一個欄位排序實體。 您不能依欄位 x 排序實體清單，也無法依欄位 y 排序 x 中的實體清單，依此類推。 如果您在鏈結或個別選取器呼叫中指定多個呼叫，則腳本會使用上 orderBy() 一個 orderBy() 呼叫中指定的欄位來排序實體清單。 

引數

名稱 類型 說明
orderBy 字串 要套用的順序。

傳回

類型 說明
AdGroupExcludedAudienceSelector 已套用排序的選取器。

withCondition (字串條件)

將篩選準則套用至廣告群組排除的物件。

指定 「columnName 運算子值」 格式 的條件 參數，其中：

運算子

您使用的運算子取決於資料行的類型。 運算子會區分大小寫。 例如，使用 STARTS_WITH 而非 starts_with。

包含整數和長值之資料行的運算子：

<
<=
>
>=
=
!=

包含雙精度浮點數之資料行的運算子：

<
>

包含字串值之資料行的運算子：

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

包含列舉值之資料行的運算子：

=
!=
IN []
NOT_IN []

包含字串陣列之資料行的運算子：

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

支援的資料行

廣告群組支援的欄排除物件篩選。 名稱區分大小寫。

以下是您可以指定的實體屬性。

欄位 類型 範例
AdGroupName 字串 關聯的廣告群組名稱。

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus 枚舉 關聯廣告群組的狀態。 可能區分大小寫的值為：
  • 啟用
  • 暫停
  • 刪除
此範例只會傳回已暫停父廣告群組的廣告群組排除物件。

withCondition("AdGroupStatus = PAUSED")
AudienceId long 相關聯物件的識別碼。

withCondition("AudienceId = 123456789")
CampaignName 字串 包含關聯廣告群組的行銷活動名稱。

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus 枚舉 包含關聯廣告群組的行銷活動狀態。 可能區分大小寫的值為：
  • 啟用
  • 暫停
  • 刪除
此範例只會傳回已暫停父活動之排除的廣告群組物件。

withCondition("CampaignStatus = PAUSED")
狀態 枚舉 關聯的狀態。 可能區分大小寫的值為：
  • 啟用
  • 暫停
  • 刪除
此範例只會傳回已啟用的廣告群組排除物件。

withCondition("Status = ENABLED")
UserListName 字串 相關聯物件的名稱。

withCondition("UserListName = 'foo'")

引數

名稱 類型 說明
條件 字串 要套用至選取器的條件。

傳回

類型 說明
AdGroupExcludedAudienceSelector 已套用條件的選取器。

withIds (string[] ids)

取得具有指定識別碼的廣告群組排除物件。

您可以將一或多個條件套用至選取器。 條件鏈結會被視為 AND 作業。 例如，只有在條件 A 為 true 且條件 B 為 true 時，才會選取實體。 例如，下列通話只會選取排除廣告群組的物件 33333。

var selector = AdsApp.adGroups()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

引數

名稱 類型 說明
Id string[] 廣告群組排除的物件識別碼陣列。 如需限制，請參閱 腳本執行限制。

傳回

類型 說明
AdGroupExcludedAudienceSelector 已套用識別碼的選取器。

withLimit (int 限制)

取得符合選取準則的前 n 個廣告群組排除物件。

引數

名稱 類型 說明
限制 int 要傳回的廣告群組排除物件數目。 實際數目可能較少。

傳回

類型 說明
AdGroupExcludedAudienceSelector 已套用限制的選取器。