Adunits

如果您想知道這個資源可使用哪些方法,請參閱本頁結尾處。

資源表示法

{
  "code": string,
  "id": string,
  "kind": "adsense#adUnit",
  "name": string,
  "status": string,
  "customStyle": {
    "kind": "adsense#adStyle",
     "colors": {
      "border": string,
      "title": string,
      "background": string,
      "text": string,
      "url": string
    },
    "corners": string,
    "font": {
      "family": string,
      "size": string
    }
  },
  "savedStyleId": string,
   "contentAdsSettings": {
    "type": string,
    "size": string,
    "backupOption": {
      "type": string,
      "color": string,
      "url": string
    }
  },
  "mobileContentAdsSettings": {
    "type": string,
    "size": string,
    "markupLanguage": string,
    "scriptingLanguage": string
  },
  "feedAdsSettings": {
    "type": string,
    "minimumWordCount": integer,
    "frequency": integer,
    "adPosition": string
  }
}
屬性名稱 說明 備註
code string 此廣告單元的身分代碼,不同的廣告用戶端上使用的代碼有可能出現重複的情形。
contentAdsSettings object 內容廣告和高階行動內容廣告的專屬設定。
contentAdsSettings.backupOption object 無廣告時實例中所用的備用選項。
contentAdsSettings.backupOption.color string 類型設定成 COLOR 時使用的顏色。
contentAdsSettings.backupOption.type string 備份選項的類型。可能的值為 BLANK、COLOR 和 URL。

可接受的值為:
  • "BLANK":
  • "COLOR":
  • "URL":
contentAdsSettings.backupOption.url string 類型設定成 URL 時使用的網址。
contentAdsSettings.size string 此廣告單元的大小。
contentAdsSettings.type string 此廣告單元的類型。
customStyle nested object 此廣告單元專屬的自訂樣式資訊。
customStyle.colors object 樣式中包含的顏色。這類屬性以六個十六進位字元表示,類似 HTML 色碼,但沒有前置雜湊。
customStyle.colors.background string 廣告背景的顏色。
customStyle.colors.border string 廣告邊框的顏色。
customStyle.colors.text string 廣告文字的顏色。
customStyle.colors.title string 廣告標題的顏色。
customStyle.colors.url string 廣告網址的顏色。
customStyle.corners string 廣告邊角的樣式。

可接受的值為:
  • "SLIGHTLY_ROUNDED":
  • "SQUARE":
  • "VERY_ROUNDED":
customStyle.font object 樣式中包含的字型。
customStyle.font.family string 字型系列。

可接受的值為:
  • "ACCOUNT_DEFAULT_FAMILY":
  • "ADSENSE_DEFAULT_FAMILY":
  • "ARIAL":
  • "LORA":
  • "OPEN_SANS":
  • "OPEN_SANS_LIGHT":
  • "ROBOTO_LIGHT":
  • "TIMES":
  • "UBUNTU_LIGHT":
  • "VERDANA":
customStyle.font.size string 字型的大小。

可接受的值為:
  • "ACCOUNT_DEFAULT_SIZE":
  • "ADSENSE_DEFAULT_SIZE":
  • "LARGE":
  • "MEDIUM":
  • "SMALL":
customStyle.kind string 此為種類,此處為 adsense#adStyle。
feedAdsSettings object 資訊提供廣告 (AFF) 的專屬設定。
feedAdsSettings.adPosition string 與資訊提供項目相對的廣告位置。

可接受的值為:
  • "BOTTOM":
  • "TOP":
feedAdsSettings.frequency integer 廣告應出現在資訊提供項目中的頻率 (亦即,每隔多少個項目應出現一次)。
feedAdsSettings.minimumWordCount integer 項目可加進廣告的最短長度。
feedAdsSettings.type string 應顯示的廣告類型。
id string 此廣告單元的專屬識別碼。這應該視為不透明識別碼,使用任一格式都不保險。
kind string 此為資源種類,此處為 adsense#adUnit。
mobileContentAdsSettings object WAP 行動內容廣告 (AFMC) 專屬的設定。
mobileContentAdsSettings.markupLanguage string 此廣告單元使用的標記語言。

可接受的值為:
  • "CHTML":
  • "WML":
  • "XHTML":
mobileContentAdsSettings.scriptingLanguage string 此廣告單元使用的指令碼語言。

可接受的值為:
  • "ASP":
  • "CGI":
  • "JSP":
  • "PHP":
mobileContentAdsSettings.size string 此廣告單元的大小。
mobileContentAdsSettings.type string 此廣告單元的類型。
name string 此廣告單元的名稱。
savedStyleId string 廣告樣式存檔的編號,該編號含有此廣告單元的樣式資訊。
status string 此廣告單元的狀態。可能的值有:

NEW:代表廣告單元是在近 7 天內建立,且尚未連結任何活動。

ACTIVE:代表此廣告單元近 7 天內一直都有活動。

INACTIVE:代表此廣告單元近 7 天內一直都沒有活動。



可接受的值為:
  • "ACTIVE":
  • "INACTIVE":
  • "NEW":

方法

get
根據指定廣告用戶端,取得某個廣告單元。
getAdCode
根據指定廣告單元,取得廣告程式碼。
list
根據此 AdSense 帳戶,列出某個廣告用戶端的所有廣告單元。