ExpandedTextAd

包含用來管理延展型文字廣告的方法。

此物件衍生自 Ad 物件。 方法清單包含所有適用的繼承方法。

注意事項

  • 在 2023 年 2 月 1 日之前，將延展型文字廣告升級為回應式搜尋廣告。 在此日期之後，您就無法再建立新項目或編輯現有的延展型文字廣告。 如需詳細資訊，請參閱 關於回應式搜尋廣告。
  • 現有的延展型文字廣告會繼續刊登，而且您將可以檢視其成效報告。
  • 您仍然可以暫停、啟用或移除延展型文字廣告。 否則，嘗試新增或更新延展型文字廣告 CampaignServiceAdTypeInvalid 會導致錯誤。
  • 深入了解此變更。

方法

方法名稱 傳回類型 描述 Inherited
applyLabel (字串名稱) void 將標籤套用至此廣告。 否
asType AdViewSpace 包含用來將此廣告投射到特定廣告類型的方法。 是
[啟用] void 啟用此廣告。 是
getAdGroup 廣告群組 取得此廣告所屬的廣告群組。 是
getCampaign 行銷活動 取得此廣告所屬的廣告活動。 是
getDescription 字串 取得此廣告的第一個說明。 此方法已過時，取而代之的是 getDescription1。 是
getDescription1 字串 取得此廣告的第一個說明。 這個方法會傳回與 getDescription 相同的值。 否
getDescription2 字串 取得此廣告的第二個說明。 否
getEntityType 字串 取得此實體的類型。 是
getHeadlinePart1 字串 取得此廣告標題的第一部分。 否
getHeadlinePart2 字串 取得此廣告標題的第二部分。 否
getHeadlinePart3 字串 取得此廣告標題的第三部分。 否
getId 字串 取得可唯一識別此廣告的 ID。 是
getPath1 字串 取得附加至此廣告顯示 URL 的選用第一個路徑。 否
getPath2 字串 取得附加至此廣告顯示 URL 的第二個選擇性路徑。 否
getPolicyApprovalStatus 字串 取得此廣告的編輯核准狀態。 是
getStats 統計資料 取得此廣告的成效資料。 是
getType 字串 取得此廣告的衍生類型。 是
isEnabled 布林值 取得布林值，指出是否已啟用此廣告。 是
isPaused 布林值 取得布林值，指出此廣告是否已暫停。 是
isType AdTypeSpace 包含用來測試廣告是否屬於指定類型的方法。 是
標籤 LabelSelector 取得用來篩選與此廣告相關聯的標籤清單的 選取器 。 否
暫停 void 暫停此廣告。 是
remove void 移除此廣告。 是
removeLabel (字串名稱) void 移除此廣告的標籤。 否
URL 廣告網址 包含用來取得此廣告最終 URL、追蹤範本和自訂參數的方法。 是

applyLabel (字串名稱)

將標籤套用至廣告。

最多可以套用 50 個標籤至一個廣告。 如需將標籤新增至實體的範例，請參閱 使用標籤。

引數

名稱 類型 描述
Name 字串 標籤的區分大小寫的名稱。 若要取得此帳戶中可套用的標籤清單，請參閱 AdsApp.labels。

傳回

類型 描述
void 會傳回 nothing。

asType

包含用來將此廣告投射到特定廣告類型的方法。

傳回

類型 描述
AdViewSpace 包含用來將此廣告投射到特定廣告類型的方法。

[啟用]

啟用此廣告。 (繼承的)

傳回

類型 描述
void 會傳回 nothing。

getAdGroup

取得此廣告所屬的廣告群組。

傳回

類型 描述
廣告群組 此廣告所屬的廣告群組。

getCampaign

取得此廣告所屬的廣告活動。

傳回

類型 描述
行銷活動 此廣告所屬的行銷活動。

getDescription

取得此廣告的第一個說明。 此方法已過時，取而代之的是 getDescription1。

傳回

類型 描述
字串 廣告的第一個描述。

getDescription1

取得此廣告的第一個說明。 這個方法會傳回與 getDescription 相同的值。

傳回

類型 描述
字串 廣告的第一個描述。

getDescription2

取得此廣告的第二個說明。

傳回

類型 描述
字串 廣告的第二個說明。

getEntityType

取得此實體的類型。

傳回

類型 描述
字串 此實體的類型，即 Ad。

getHeadlinePart1

取得此廣告標題的第一部分。

傳回

類型 描述
字串 這個廣告標題的第一部分。

getHeadlinePart2

取得此廣告標題的第二部分。

傳回

類型 描述
字串 這個廣告標題的第二部分。

getHeadlinePart3

取得此廣告標題的第三部分。

傳回

類型 描述
字串 這個廣告標題的第三部分。

getId

取得可唯一識別此廣告的 ID。

傳回

類型 描述
字串 唯一識別此廣告的 ID。

getPath1

取得附加至此廣告顯示 URL 的選用第一個路徑。

傳回

類型 描述
字串 附加到此廣告顯示 URL 的第一個路徑。

getPath2

取得附加至此廣告顯示 URL 的第二個選擇性路徑。

傳回

類型 描述
字串 附加至此廣告顯示 URL 的第二個路徑。

getPolicyApprovalStatus

取得此廣告的編輯核准狀態。

傳回

類型 描述
字串 廣告的編輯核准狀態。 下列為可能的值。
  • 已核准
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • 未核准

getStats

取得此廣告的成效資料。

若要呼叫這個方法，您必須在廣告選取器的鏈結中包含其中一個forDateRange方法。

傳回

類型 描述
統計資料 廣告的成效資料。

getType

取得此廣告的衍生類型。

傳回

類型 描述
字串 此廣告的衍生類型。 以下是可能的類型。
  • EXPANDED_TEXT_AD
.

isEnabled

取得布林值，指出是否已啟用此廣告。

傳回

類型 描述
布林值 如果已啟用此廣告，則為 True ;否則為 false。

isPaused

取得布林值，指出此廣告是否已暫停。

傳回

類型 描述
布林值 如果此廣告已暫停，則為 True ;否則為 false。

isType

包含用來測試廣告是否屬於指定類型的方法。

傳回

類型 描述
AdTypeSpace 包含用來測試廣告是否屬於指定類型的方法。

標籤

取得用來篩選與此廣告相關聯的標籤清單的 選取器 。

傳回

類型 描述
LabelSelector 用來篩選與此廣告相關聯的標籤清單的選取器。

暫停

暫停此廣告。

傳回

類型 描述
void 會傳回 nothing。

移除

移除此廣告。

傳回

類型 描述
void 會傳回 nothing。

removeLabel (字串名稱)

移除廣告上的標籤。

引數

名稱 類型 描述
Name 字串 標籤的區分大小寫的名稱。 若要取得與此廣告相關聯的標籤清單，請參閱 標籤。

傳回

類型 描述
void 會傳回 nothing。

URL

包含用來取得此廣告最終 URL、追蹤範本和自訂參數的方法。

傳回

類型 描述
廣告網址 用來取得此廣告的最終 URL、追蹤範本和自訂參數的物件。

另請參閱

  • Last updated on