Cập nhật Thẻ GTM. Thử ngay.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/tagmanager/v2/path
Tham số
Tên thông số | Giá trị | Mô tả |
---|---|---|
Tham số đường dẫn | ||
path |
string |
Đường dẫn tương đối của API của Thẻ GTM. Ví dụ: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id} |
Tham số truy vấn không bắt buộc | ||
fingerprint |
string |
Khi được cung cấp, vân tay số này phải khớp với vân tay số của thẻ trong bộ nhớ. |
Ủy quyền
Yêu cầu này cần được cho phép có phạm vi sau:
Phạm vi |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.
Nội dung yêu cầu
Trong nội dung yêu cầu, hãy cung cấp tài nguyên thẻ với các thuộc tính sau:
Tên tài sản | Giá trị | Mô tả | Ghi chú |
---|---|---|---|
Thuộc tính bắt buộc | |||
consentSettings.consentType.type |
string |
Loại thông số. Các giá trị hợp lệ là:
Các giá trị được chấp nhận là:
|
có thể ghi |
monitoringMetadata.type |
string |
Loại thông số. Các giá trị hợp lệ là:
Các giá trị được chấp nhận là:
|
có thể ghi |
name |
string |
Tên hiển thị của thẻ. | có thể ghi |
parameter[].type |
string |
Loại thông số. Các giá trị hợp lệ là:
Các giá trị được chấp nhận là:
|
có thể ghi |
priority.type |
string |
Loại thông số. Các giá trị hợp lệ là:
Các giá trị được chấp nhận là:
|
có thể ghi |
type |
string |
Loại thẻ GTM. | có thể ghi |
Thuộc tính không bắt buộc | |||
blockingRuleId[] |
list |
Mã quy tắc chặn. Nếu bất kỳ quy tắc nào được liệt kê đánh giá là true, thì thẻ sẽ không kích hoạt. | có thể ghi |
blockingTriggerId[] |
list |
Chặn mã điều kiện kích hoạt. Nếu bất kỳ trình kích hoạt nào được liệt kê đánh giá là true, thì thẻ sẽ không kích hoạt. | có thể ghi |
consentSettings |
nested object |
Chế độ cài đặt lấy sự đồng ý của một thẻ. | có thể ghi |
consentSettings.consentType.key |
string |
Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các giá trị danh sách. | có thể ghi |
consentSettings.consentType.list[] |
list |
Các tham số của tham số danh sách này (các khoá sẽ bị bỏ qua). | có thể ghi |
consentSettings.consentType.map[] |
list |
Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). | có thể ghi |
consentSettings.consentType.value |
string |
Giá trị của thông số (có thể chứa các biến tham chiếu như "") phù hợp với loại đã chỉ định. | có thể ghi |
firingRuleId[] |
list |
Mã quy tắc kích hoạt. Thẻ sẽ kích hoạt khi bất kỳ quy tắc nào được liệt kê là true và tất cả blockingRuleIds của thẻ đó (nếu có) là false. |
có thể ghi |
firingTriggerId[] |
list |
Mã kích hoạt. Thẻ sẽ kích hoạt khi bất kỳ điều kiện kích hoạt nào được liệt kê là true và tất cả blockingTriggerIds của thẻ đó (nếu có) là false. |
có thể ghi |
liveOnly |
boolean |
Nếu bạn đặt thành true, thẻ này sẽ chỉ kích hoạt trong môi trường hoạt động (ví dụ: không ở chế độ xem trước hoặc gỡ lỗi). | có thể ghi |
monitoringMetadata |
nested object |
Liên kết các cặp khoá-giá trị của siêu dữ liệu thẻ sẽ được đưa vào dữ liệu sự kiện để theo dõi thẻ. Lưu ý:
|
có thể ghi |
monitoringMetadata.key |
string |
Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các giá trị danh sách. | có thể ghi |
monitoringMetadata.list[] |
list |
Các tham số của tham số danh sách này (các khoá sẽ bị bỏ qua). | có thể ghi |
monitoringMetadata.map[] |
list |
Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). | có thể ghi |
monitoringMetadata.value |
string |
Giá trị của thông số (có thể chứa các biến tham chiếu như "") phù hợp với loại đã chỉ định. | có thể ghi |
monitoringMetadataTagNameKey |
string |
Nếu không để trống thì tên hiển thị thẻ sẽ được đưa vào bản đồ siêu dữ liệu giám sát bằng cách sử dụng khoá đã chỉ định. | có thể ghi |
notes |
string |
Ghi chú của người dùng về cách áp dụng thẻ này trong vùng chứa. | có thể ghi |
parameter[] |
list |
Thông số của thẻ. | có thể ghi |
parameter[].key |
string |
Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các giá trị danh sách. | có thể ghi |
parameter[].list[] |
list |
Các tham số của tham số danh sách này (các khoá sẽ bị bỏ qua). | có thể ghi |
parameter[].map[] |
list |
Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). | có thể ghi |
parameter[].value |
string |
Giá trị của thông số (có thể chứa các biến tham chiếu như "") phù hợp với loại đã chỉ định. | có thể ghi |
paused |
boolean |
Cho biết liệu thẻ có bị tạm dừng hay không, ngăn thẻ kích hoạt. | có thể ghi |
priority |
nested object |
Mức độ ưu tiên dạng số của thẻ do người dùng xác định. Thẻ được kích hoạt không đồng bộ theo thứ tự ưu tiên. Những thẻ có giá trị số cao hơn sẽ kích hoạt trước. Mức độ ưu tiên của thẻ có thể là giá trị dương hoặc âm. Giá trị mặc định là "0". | có thể ghi |
priority.key |
string |
Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các giá trị danh sách. | có thể ghi |
priority.list[] |
list |
Các tham số của tham số danh sách này (các khoá sẽ bị bỏ qua). | có thể ghi |
priority.map[] |
list |
Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). | có thể ghi |
priority.value |
string |
Giá trị của thông số (có thể chứa các biến tham chiếu như "") phù hợp với loại đã chỉ định. | có thể ghi |
scheduleEndMs |
long |
Dấu thời gian kết thúc tính bằng mili giây để lên lịch cho một thẻ. | có thể ghi |
scheduleStartMs |
long |
Dấu thời gian bắt đầu tính bằng mili giây để lên lịch cho một thẻ. | có thể ghi |
Phản hồi
Nếu thành công, phương thức này sẽ trả về một Tài nguyên thẻ trong nội dung phản hồi.
Hãy dùng thử!
Hãy sử dụng APIs Explorer (Trình khám phá API) bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.