Tags: create

建立 GTM 代碼。 立即試用。

要求

HTTP 要求

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

參數

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

授權

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

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

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

要求主體

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

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


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
monitoringMetadata.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"
 可寫入
priority.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 代碼類型。 可寫入
選用屬性
blockingRuleId[] list 封鎖規則 ID。如果清單中的任何規則評估結果為 true，代碼就不會觸發。 可寫入
blockingTriggerId[] list 封鎖觸發條件 ID。如果清單中的任何觸發條件評估結果為 true，代碼就不會觸發。 可寫入
consentSettings nested object 代碼的同意聲明設定。 可寫入
consentSettings.consentType.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
consentSettings.consentType.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
consentSettings.consentType.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
consentSettings.consentType.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
firingRuleId[] list 觸發規則 ID。只要列出的規則為 true，且其所有 blockingRuleIds (如有指定) 皆為 false，標記就會觸發。 可寫入
firingTriggerId[] list 觸發條件 ID。如果列出的觸發條件其中一項為 true，blockingTriggerIds (如果有的話) 全都為 false，代碼就會觸發。 可寫入
liveOnly boolean 如果設為 true，這個代碼只會在實際環境中觸發 (例如在預覽或偵錯模式下)。 可寫入
monitoringMetadata nested object 要納入事件資料中以便監控代碼的代碼中繼資料鍵/值組合的對應。附註：
  • 這個參數必須是 MAP 類型。
  • 對應中的每個參數都是 TEMPLATE 類型，但不能包含變數參照。
 可寫入
monitoringMetadata.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
monitoringMetadata.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
monitoringMetadata.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
monitoringMetadata.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
monitoringMetadataTagNameKey string 如果非空白，系統會使用指定的鍵，將標記顯示名稱納入監控中繼資料對應中。 可寫入
notes string 使用者在容器中套用這個代碼的附註。 可寫入
parameter[] list 代碼的參數。 可寫入
parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
parameter[].map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
paused boolean 表示代碼是否已暫停，以防代碼觸發。 可寫入
priority nested object 使用者定義的代碼數字優先順序。代碼會按照優先順序以非同步方式觸發。數值較高的代碼會先觸發。標記的優先順序可以是正值或負值。預設值為 0。 可寫入
priority.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
priority.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
priority.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
priority.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
scheduleEndMs long 排定代碼的結束時間戳記 (以毫秒為單位)。 可寫入
scheduleStartMs long 排定代碼的開始時間戳記 (以毫秒為單位)。 可寫入

回應

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

試試看！

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