Tags: create

Tạo thẻ GTM. Thử ngay.

Yêu cầu

Yêu cầu HTTP

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

Các tham số

Tên thông số Giá trị Nội dung mô tả
Tham số đường dẫn
parent string Đường dẫn tương đối về API của GTM Workspace. Ví dụ: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Ủy quyền

Yêu cầu này cần được uỷ quyền với 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ị Nội dung mô tả Ghi chú
Thuộc tính bắt buộc
consentSettings.consentType.type string Loại tham số. Các giá trị hợp lệ là:
  • boolean: Giá trị đại diện cho một boolean, được biểu thị dưới dạng "true" hoặc "false"
  • integer: Giá trị này biểu thị giá trị số nguyên 64 bit đã ký, ở cơ số 10
  • list: Danh sách các thông số phải được chỉ định
  • map: Bản đồ các tham số phải được chỉ định
  • template: Giá trị đại diện cho văn bản bất kỳ; giá trị này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt
  • tag_reference: Giá trị đại diện cho một thẻ, được thể hiện dưới dạng tên thẻ


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 có thể ghi
monitoringMetadata.type string Loại tham số. Các giá trị hợp lệ là:
  • boolean: Giá trị đại diện cho một boolean, được biểu thị dưới dạng "true" hoặc "false"
  • integer: Giá trị này biểu thị giá trị số nguyên 64 bit đã ký, ở cơ số 10
  • list: Danh sách các thông số phải được chỉ định
  • map: Bản đồ các tham số phải được chỉ định
  • template: Giá trị đại diện cho văn bản bất kỳ; giá trị này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt
  • tag_reference: Giá trị đại diện cho một thẻ, được thể hiện dưới dạng tên thẻ


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 có thể ghi
name string Tên hiển thị của thẻ. có thể ghi
parameter[].type string Loại tham số. Các giá trị hợp lệ là:
  • boolean: Giá trị đại diện cho một boolean, được biểu thị dưới dạng "true" hoặc "false"
  • integer: Giá trị này biểu thị giá trị số nguyên 64 bit đã ký, ở cơ số 10
  • list: Danh sách các thông số phải được chỉ định
  • map: Bản đồ các tham số phải được chỉ định
  • template: Giá trị đại diện cho văn bản bất kỳ; giá trị này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt
  • tag_reference: Giá trị đại diện cho một thẻ, được thể hiện dưới dạng tên thẻ


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 có thể ghi
priority.type string Loại tham số. Các giá trị hợp lệ là:
  • boolean: Giá trị đại diện cho một boolean, được biểu thị dưới dạng "true" hoặc "false"
  • integer: Giá trị này biểu thị giá trị số nguyên 64 bit đã ký, ở cơ số 10
  • list: Danh sách các thông số phải được chỉ định
  • map: Bản đồ các tham số phải được chỉ định
  • template: Giá trị đại diện cho văn bản bất kỳ; giá trị này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt
  • tag_reference: Giá trị đại diện cho một thẻ, được thể hiện dưới dạng tên thẻ


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 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à đúng, 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ỳ điều kiện kích hoạt nào được liệt kê có giá trị là true, thì thẻ này sẽ không kích hoạt. có thể ghi
consentSettings nested object Chế độ cài đặt về sự đồng ý của một thẻ. có thể ghi
consentSettings.consentType.key string Khoá được đặt tên xác định duy nhất một tham số. Bắt buộc đối với các thông số cấp cao nhất, cũng như giá trị bản đồ. Bỏ qua đối với 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 Tham số của thông số bản đồ này (phải có khoá; các 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 tham chiếu biến như "") phù hợp với loại được 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ó được chỉ định) là false. có thể ghi
firingTriggerId[] list Mã điều kiện kích hoạt 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à đúng và tất cả blockingTriggerIds của thẻ đó (nếu có bất kỳ được chỉ định) nào là sai. có thể ghi
liveOnly boolean Nếu bạn đặt chính sách này thành true, thì thẻ này sẽ chỉ kích hoạt trong môi trường trực tiếp (ví dụ: không ở chế độ xem trước hoặc gỡ lỗi). có thể ghi
monitoringMetadata nested object Bản đồ 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 ý:
  • Tham số này phải ở kiểu MAP.
  • Mỗi tham số trong bản đồ đều thuộc loại TEMPLATE, tuy nhiên không thể chứa các tham chiếu biến.
 có thể ghi
monitoringMetadata.key string Khoá được đặt tên xác định duy nhất một tham số. Bắt buộc đối với các thông số cấp cao nhất, cũng như giá trị bản đồ. Bỏ qua đối với 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 Tham số của thông số bản đồ này (phải có khoá; các 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 tham chiếu biến như "") phù hợp với loại được 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 khoá được 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 xác định duy nhất một tham số. Bắt buộc đối với các thông số cấp cao nhất, cũng như giá trị bản đồ. Bỏ qua đối với 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 Tham số của thông số bản đồ này (phải có khoá; các 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 tham chiếu biến như "") phù hợp với loại được 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. 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 xác định duy nhất một tham số. Bắt buộc đối với các thông số cấp cao nhất, cũng như giá trị bản đồ. Bỏ qua đối với 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 Tham số của thông số bản đồ này (phải có khoá; các 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 tham chiếu biến như "") phù hợp với loại được 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 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.