衍生廣告的基底物件，例如延展型文字廣告。
這個物件也代表標準文字廣告。 您不得再建立標準文字廣告，但可以擷取、暫停、移除及啟用它們。 下列方法不適用於衍生物件，因此不應呼叫。
- getDestinationUrl ()
- getDisplayUrl ()
- getHeadline ()
- isMobilePreferred ()
注意事項
方法
| 方法名稱 | 傳回類型 | 描述 |
|---|---|---|
| applyLabel (字串名稱) | void | 將標籤套用至此廣告。 |
| asType | AdViewSpace | 包含用來將此廣告投射到特定廣告類型的方法。 |
| [啟用] | void | 啟用此廣告。 |
| getAdGroup | 廣告群組 | 取得此廣告所屬的廣告群組。 |
| getCampaign | 行銷活動 | 取得此廣告所屬的廣告活動。 |
| getDescription | 字串 | 取得此廣告的文案文字。 |
| getDestinationUrl | 字串 | 取得使用者在點選廣告時進入的網頁 URL。 |
| getDisplayUrl | 字串 | 取得廣告中顯示的網址。 |
| getEntityType | 字串 | 取得此實體的類型。 |
| getHeadline | 字串 | 取得此廣告的標題。 |
| getId | 字串 | 取得可唯一識別此廣告的 ID。 |
| getPolicyApprovalStatus | 字串 | 取得此廣告的編輯核准狀態。 |
| getStats | 統計資料 | 取得此廣告的成效資料。 |
| getType | 字串 | 取得此廣告的衍生類型。 |
| isEnabled | 布林值 | 取得布林值，指出是否已啟用此廣告。 |
| isMobilePreferred | 布林值 | 取得布林值，指出偏好是讓此廣告顯示在行動裝置上還是在所有裝置上。 |
| 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
取得此廣告的文案文字。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告的文案文字。 |
getDestinationUrl
取得使用者在點選廣告時進入的網頁 URL。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 當使用者點擊廣告時，會被帶往的網頁 URL。 如果從衍生物件呼叫，則傳回 null。 |
getDisplayUrl
取得廣告中顯示的網址。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 顯示在廣告中的 URL。 如果從衍生物件呼叫，則傳回 null。 |
getEntityType
取得此實體的類型。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此實體的類型，即 Ad。 |
getHeadline
取得此廣告的標題。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 廣告標題。 如果從衍生物件呼叫，則傳回 null。 |
getId
取得可唯一識別此廣告的 ID。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 唯一識別此廣告的 ID。 |
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、追蹤範本和自訂參數的方法。
傳回
| 類型 | 描述 |
|---|---|
| 廣告網址 | 用來取得此廣告的最終 URL、追蹤範本和自訂參數的物件。 |