ExpandedTextAd
包含用來管理展開文字廣告的方法。
這個物件衍生自 Ad 物件。 方法清單包含所有適用的繼承方法。
注意事項
- 在 2023 年 2 月 1 日前，將擴充的文字廣告升級至回應式搜尋廣告。 在此日期之後，您將無法再建立新的或編輯現有的展開文字廣告。 如需詳細資訊，請 參閱關於回應式搜尋廣告。
- 現有的展開文字廣告將會繼續提供，而且您將能夠檢視其效能的報告。
- 您仍然可以暫停、啟用或移除展開的文字廣告。 否則，嘗試新增或更新展開的文字廣告會導致
CampaignServiceAdTypeInvalid錯誤。 - 深入瞭解這項變更。
方法
| 方法名稱 | 傳回類型 | 說明 | Inherited |
|---|---|---|---|
| applyLabel (字串名稱) | void | 將標籤套用至此廣告。 | 否 |
| asType | AdViewSpace | 包含用來將此廣告轉換成特定廣告類型的方法。 | 是 |
| 使 | void | 啟用此廣告。 | 是 |
| getAdGroup | AdGroup | 取得此廣告所屬的廣告群組。 | 是 |
| getCampaign | 行銷活動 | 取得此廣告所屬的行銷活動。 | 是 |
| getDescription | 字串 | 取得此廣告的第一個描述。 這個方法已被取代，而改用 getDescription1。 | 是 |
| getDescription1 | 字串 | 取得此廣告的第一個描述。 這個方法會傳回與 getDescription相同的值。 | 否 |
| getDescription2 | 字串 | 取得此廣告的第二個描述。 | 否 |
| getEntityType | 字串 | 取得這個實體的類型。 | 是 |
| getHeadlinePart1 | 字串 | 取得此廣告標題的第一個部分。 | 否 |
| getHeadlinePart2 | 字串 | 取得此廣告標題的第二個部分。 | 否 |
| getHeadlinePart3 | 字串 | 取得此廣告標題的第三個部分。 | 否 |
| getId | 字串 | 取得可唯一識別此廣告的識別碼。 | 是 |
| getPath1 | 字串 | 取得附加至此廣告顯示 URL 的選擇性第一個路徑。 | 否 |
| getPath2 | 字串 | 取得附加至此廣告顯示 URL 的選擇性第二個路徑。 | 否 |
| getPolicyApprovalStatus | 字串 | 取得此廣告的編輯核准狀態。 | 是 |
| getStats | 統計 | 取得此廣告的效能資料。 | 是 |
| getType | 字串 | 取得此廣告的衍生類型。 | 是 |
| isEnabled | 布林值 | 取得布林值，指出是否已啟用此廣告。 | 是 |
| isPaused | 布林值 | 取得布林值，指出此廣告是否已暫停。 | 是 |
| isType | AdTypeSpace | 包含用來測試廣告是否為指定類型的方法。 | 是 |
| 標籤 | LabelSelector | 取得 選取器 ，用來篩選與此廣告相關聯的標籤清單。 | 否 |
| 暫停 | void | 暫停此廣告。 | 是 |
| remove | void | 移除此廣告。 | 是 |
| removeLabel (字串名稱) | void | 從此廣告中移除標籤。 | 否 |
| Url | AdUrls | 包含用來取得此廣告最終 URL、追蹤範本和自訂參數的方法。 | 是 |
applyLabel (字串名稱)
將標籤套用至廣告。
您最多可以將 50 個標籤套用至廣告。 如需將標籤新增至實體的範例，請參閱 使用標籤。
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| Name | 字串 | 標籤的區分大小寫名稱。 若要取得此帳戶中您可以套用的標籤清單，請參閱 AdsApp.labels。 |
傳回
| 類型 | 說明 |
|---|---|
| void | 會傳回 nothing。 |
asType
包含用來將此廣告轉換成特定廣告類型的方法。
傳回
| 類型 | 說明 |
|---|---|
| AdViewSpace | 包含用來將此廣告轉換成特定廣告類型的方法。 |
使
啟用此廣告。 (繼承)
傳回
| 類型 | 說明 |
|---|---|
| void | 會傳回 nothing。 |
getAdGroup
取得此廣告所屬的廣告群組。
傳回
| 類型 | 說明 |
|---|---|
| AdGroup | 此廣告所屬的廣告群組。 |
getCampaign
取得此廣告所屬的行銷活動。
傳回
| 類型 | 說明 |
|---|---|
| 行銷活動 | 此廣告所屬的行銷活動。 |
getDescription
取得此廣告的第一個描述。 這個方法已被取代，而改用 getDescription1。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告的第一個描述。 |
getDescription1
取得此廣告的第一個描述。 這個方法會傳回與 getDescription相同的值。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告的第一個描述。 |
getDescription2
取得此廣告的第二個描述。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告的第二個描述。 |
getEntityType
取得這個實體的類型。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此實體的類型，也就是 Ad。 |
getHeadlinePart1
取得此廣告標題的第一個部分。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此廣告標題的第一個部分。 |
getHeadlinePart2
取得此廣告標題的第二個部分。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此廣告標題的第二個部分。 |
getHeadlinePart3
取得此廣告標題的第三個部分。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此廣告標題的第三個部分。 |
getId
取得可唯一識別此廣告的識別碼。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 可唯一識別此廣告的識別碼。 |
getPath1
取得附加至此廣告顯示 URL 的選擇性第一個路徑。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 附加至此廣告顯示 URL 的第一個路徑。 |
getPath2
取得附加至此廣告顯示 URL 的選擇性第二個路徑。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 附加至此廣告顯示 URL 的第二個路徑。 |
getPolicyApprovalStatus
取得此廣告的編輯核准狀態。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告的編輯核准狀態。 以下是可能的值。
|
getStats
取得此廣告的效能資料。
若要呼叫這個方法，您必須在廣告選取器的鏈結中包含其中 forDateRange 一個方法。
傳回
| 類型 | 說明 |
|---|---|
| 統計 | 廣告的效能資料。 |
getType
取得此廣告的衍生類型。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此廣告的衍生類型。 以下是可能的類型。
|
isEnabled
取得布林值，指出是否已啟用此廣告。
傳回
| 類型 | 說明 |
|---|---|
| 布林值 | 如果已啟用此廣告，則為 true ;否則為 false。 |
isPaused
取得布林值，指出此廣告是否已暫停。
傳回
| 類型 | 說明 |
|---|---|
| 布林值 | 如果暫停此廣告，則為 true ;否則為 false。 |
isType
包含用來測試廣告是否為指定類型的方法。
傳回
| 類型 | 說明 |
|---|---|
| AdTypeSpace | 包含用來測試廣告是否為指定類型的方法。 |
標籤
取得 選取器 ，用來篩選與此廣告相關聯的標籤清單。
傳回
| 類型 | 說明 |
|---|---|
| LabelSelector | 選取器，用來篩選與此廣告相關聯的標籤清單。 |
暫停
暫停此廣告。
傳回
| 類型 | 說明 |
|---|---|
| void | 會傳回 nothing。 |
刪除
移除此廣告。
傳回
| 類型 | 說明 |
|---|---|
| void | 會傳回 nothing。 |
removeLabel (字串名稱)
從廣告中移除標籤。
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| Name | 字串 | 標籤的區分大小寫名稱。 若要取得與此廣告相關聯的標籤清單，請參閱 標籤。 |
傳回
| 類型 | 說明 |
|---|---|
| void | 會傳回 nothing。 |
Url
包含用來取得此廣告最終 URL、追蹤範本和自訂參數的方法。
傳回
| 類型 | 說明 |
|---|---|
| AdUrls | 物件，用來取得此廣告的最終 URL、追蹤範本和自訂參數。 |