Variables: create

建立 GTM 變數。 立即試用。

要求

HTTP 要求

POST https://www.googleapis.com/tagmanager/v2/+parent/variables

參數

參數名稱 值 說明
路徑參數
parent string GTM Workspace 的 API 相對路徑。範例：accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

授權

此要求需要取得下列範圍的授權：

範圍
https://www.googleapis.com/auth/tagmanager.edit.containers

詳情請參閱驗證和授權頁面。

要求主體

在要求主體中，提供具有以下屬性的 Variables 資源：

資源名稱 值 說明 附註
必要屬性
formatValue.convertFalseToValue.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
formatValue.convertNullToValue.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
formatValue.convertTrueToValue.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
formatValue.convertUndefinedToValue.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
name string 變數顯示名稱。 可寫入
parameter[].type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
type string GTM 變數類型。 可寫入
選用屬性
disablingTriggerId[] list 僅適用於行動容器：用於停用條件變數的觸發條件 ID 清單；如果其中一個啟用觸發條件為 True，但所有停用觸發條件都是 False，變數就會啟用。視為未排序的集合。 可寫入
enablingTriggerId[] list 僅適用於行動容器：用於啟用條件變數的觸發條件 ID 清單；如果其中一個啟用觸發條件為 True，但所有停用觸發條件皆為 false，變數就會啟用。視為未排序的集合。 可寫入
formatValue.convertFalseToValue.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
formatValue.convertFalseToValue.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
formatValue.convertFalseToValue.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
formatValue.convertFalseToValue.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
formatValue.convertNullToValue.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
formatValue.convertNullToValue.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
formatValue.convertNullToValue.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
formatValue.convertNullToValue.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
formatValue.convertTrueToValue.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
formatValue.convertTrueToValue.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
formatValue.convertTrueToValue.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
formatValue.convertTrueToValue.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
formatValue.convertUndefinedToValue.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
formatValue.convertUndefinedToValue.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
formatValue.convertUndefinedToValue.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
formatValue.convertUndefinedToValue.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
notes string 使用者說明如何在容器中套用這個變數。 可寫入
parameter[] list 變數的參數。 可寫入
parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
parameter[].map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
scheduleEndMs long 安排變數的結束時間戳記 (以毫秒為單位)。 可寫入
scheduleStartMs long 安排變數的開始時間戳記 (以毫秒為單位)。 可寫入

回應

如果成功，這個方法會在回應主體中傳回 Variables 資源。

試試看！

您可以使用下方的 APIs Explorer，針對即時資料呼叫這個方法，然後查看回應。