建立 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 |
參數類型。有效的值包括:
可接受的值為:
|
可寫入 |
monitoringMetadata.type |
string |
參數類型。有效的值包括:
可接受的值為:
|
可寫入 |
name |
string |
代碼顯示名稱。 | 可寫入 |
parameter[].type |
string |
參數類型。有效的值包括:
可接受的值為:
|
可寫入 |
priority.type |
string |
參數類型。有效的值包括:
可接受的值為:
|
可寫入 |
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 |
標記中繼資料的鍵/值組合,包含在事件資料中供標記監控之用。注意事項:
|
可寫入 |
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,針對即時資料呼叫這個方法,看看會有什麼結果。