廣告
廣告衍生自的基底物件，例如展開的文字廣告。
此物件也代表標準文字廣告。 您可能不再建立標準文字廣告，但可以擷取、暫停、移除和啟用。 下列方法不適用於衍生物件，不應呼叫。
- getDestinationUrl ()
- getDisplayUrl ()
- getHeadline ()
- isMobilePreferred ()
注意事項
- 在 2023 年 2 月 1 日前，將擴充的文字廣告升級至回應式搜尋廣告。 在此日期之後，您將無法再建立新的或編輯現有的展開文字廣告。 如需詳細資訊，請 參閱關於回應式搜尋廣告。
- 現有的展開文字廣告將會繼續提供，而且您將能夠檢視其效能的報告。
- 您仍然可以暫停、啟用或移除展開的文字廣告。 否則，嘗試新增或更新展開的文字廣告會導致
CampaignServiceAdTypeInvalid錯誤。 - 深入瞭解這項變更。
方法
| 方法名稱 | 傳回類型 | 說明 |
|---|---|---|
| applyLabel (字串名稱) | void | 將標籤套用至此廣告。 |
| asType | AdViewSpace | 包含用來將此廣告轉換成特定廣告類型的方法。 |
| 使 | void | 啟用此廣告。 |
| getAdGroup | AdGroup | 取得此廣告所屬的廣告群組。 |
| getCampaign | 行銷活動 | 取得此廣告所屬的行銷活動。 |
| getDescription | 字串 | 取得此廣告的複製文字。 |
| getDestinationUrl | 字串 | 取得使用者在按一下廣告時所前往的網頁 URL。 |
| getDisplayUrl | 字串 | 取得廣告中顯示的 URL。 |
| getEntityType | 字串 | 取得這個實體的類型。 |
| getHeadline | 字串 | 取得此廣告的標題。 |
| getId | 字串 | 取得可唯一識別此廣告的識別碼。 |
| getPolicyApprovalStatus | 字串 | 取得此廣告的編輯核准狀態。 |
| getStats | 統計 | 取得此廣告的效能資料。 |
| getType | 字串 | 取得此廣告的衍生類型。 |
| isEnabled | 布林值 | 取得布林值，指出是否已啟用此廣告。 |
| isMobilePreferred | 布林值 | 取得布林值，指出此廣告的喜好設定是否要顯示在行動裝置或所有裝置上。 |
| 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
取得此廣告的複製文字。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告的複製文字。 |
getDestinationUrl
取得使用者在按一下廣告時所前往的網頁 URL。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 使用者按一下廣告時所前往的網頁 URL。 如果從衍生物件呼叫，則傳回 Null。 |
getDisplayUrl
取得廣告中顯示的 URL。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告中顯示的 URL。 如果從衍生物件呼叫，則傳回 Null。 |
getEntityType
取得這個實體的類型。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此實體的類型，也就是 Ad。 |
getHeadline
取得此廣告的標題。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告標題。 如果從衍生物件呼叫，則傳回 Null。 |
getId
取得可唯一識別此廣告的識別碼。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 可唯一識別此廣告的識別碼。 |
getPolicyApprovalStatus
取得此廣告的編輯核准狀態。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告的編輯核准狀態。 以下是可能的值。
|
getStats
取得此廣告的效能資料。
若要呼叫這個方法，您必須在廣告選取器的鏈結中包含其中 forDateRange 一個方法。
傳回
| 類型 | 說明 |
|---|---|
| 統計 | 廣告的效能資料。 |
getType
取得此廣告的衍生類型。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此廣告的衍生類型。 以下是可能的類型。
|
isEnabled
取得布林值，指出是否已啟用此廣告。
傳回
| 類型 | 說明 |
|---|---|
| 布林值 | 如果已啟用此廣告，則為 true ;否則為 false。 |
isMobilePreferred
取得布林值，指出此廣告的喜好設定是否要顯示在行動裝置或所有裝置上。
傳回
| 類型 | 說明 |
|---|---|
| 布林值 | 如果喜好設定是在行動裝置上顯示此廣告，則為 true 。 如果 為 false，則此廣告的喜好設定會顯示在所有裝置上。 |
isPaused
取得布林值，指出此廣告是否已暫停。
傳回
| 類型 | 說明 |
|---|---|
| 布林值 | 如果暫停此廣告，則為 true ;否則為 false。 |
isType
包含用來測試廣告是否為指定類型的方法。
傳回
| 類型 | 說明 |
|---|---|
| AdTypeSpace | 包含用來測試廣告是否為指定類型的方法。 |
標籤
取得 選取器 ，用來篩選與此廣告相關聯的標籤清單。
傳回
| 類型 | 說明 |
|---|---|
| LabelSelector | 選取器，用來篩選與此廣告相關聯的標籤清單。 |
暫停
暫停此廣告。
傳回
| 類型 | 說明 |
|---|---|
| void | 會傳回 nothing。 |
刪除
移除此廣告。
傳回
| 類型 | 說明 |
|---|---|
| void | 會傳回 nothing。 |
removeLabel (字串名稱)
從廣告中移除標籤。
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| Name | 字串 | 標籤的區分大小寫名稱。 若要取得與此廣告相關聯的標籤清單，請參閱 標籤。 |
傳回
| 類型 | 說明 |
|---|---|
| void | 會傳回 nothing。 |
Url
包含用來取得此廣告最終 URL、追蹤範本和自訂參數的方法。
傳回
| 類型 | 說明 |
|---|---|
| AdUrls | 物件，用來取得此廣告的最終 URL、追蹤範本和自訂參數。 |