Tags: create

建立 Google 代碼管理工具代碼。 立即試用。

要求

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：值代表以 10 為底的 64 位元帶正負號整數值
  • list：應指定參數清單
  • map：應指定參數對應
  • template：值代表任何文字；這可能包含變數參照 (包括可能會傳回非字串類型的變數參照)
  • trigger_reference：值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：值代表標記，以標記名稱表示
，瞭解如何調查及移除這項存取權。

可接受的值為：
  • 「boolean」
  • 「integer」
  • 「list」
  • 「map」
  • 「tagReference」
  • 「template」
  • 「triggerReference」
  • 「typeUnspecified」
 可寫入
monitoringMetadata.type string 參數類型。有效的值包括：
  • boolean：值代表布林值，以「true」表示或「false」
  • integer：值代表以 10 為底的 64 位元帶正負號整數值
  • 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：值代表以 10 為底的 64 位元帶正負號整數值
  • list：應指定參數清單
  • map：應指定參數對應
  • template：值代表任何文字；這可能包含變數參照 (包括可能會傳回非字串類型的變數參照)
  • trigger_reference：值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：值代表標記，以標記名稱表示
，瞭解如何調查及移除這項存取權。

可接受的值為：
  • 「boolean」
  • 「integer」
  • 「list」
  • 「map」
  • 「tagReference」
  • 「template」
  • 「triggerReference」
  • 「typeUnspecified」
 可寫入
priority.type string 參數類型。有效的值包括：
  • boolean：值代表布林值，以「true」表示或「false」
  • integer：值代表以 10 為底的 64 位元帶正負號整數值
  • 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。只要列出的任一觸發條件為「是」，且該觸發條件的所有 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，針對即時資料呼叫這個方法，看看會有什麼結果。