Variables: update

Cập nhật một biến GTM. Thử ngay.

Yêu cầu

Yêu cầu HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

Các tham số

Tên thông số Giá trị Nội dung mô tả
Tham số đường dẫn
path string Đường dẫn tương đối về API của Biến GTM. Ví dụ: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_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 biến trong bộ nhớ.

Ủ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 biến 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
formatValue.convertFalseToValue.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
formatValue.convertNullToValue.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
formatValue.convertTrueToValue.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
formatValue.convertUndefinedToValue.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 biến. 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
type string Loại biến GTM. có thể ghi
Thuộc tính không bắt buộc
disablingTriggerId[] list Chỉ đối với vùng chứa trên thiết bị di động: Danh sách mã trình kích hoạt để tắt biến có điều kiện; biến này được bật nếu một trong các trình kích hoạt đang bật là đúng trong khi tất cả trình kích hoạt tắt đều sai. Được coi là một tập hợp không theo thứ tự. có thể ghi
enablingTriggerId[] list Chỉ đối với vùng chứa trên thiết bị di động: Danh sách mã điều kiện kích hoạt để bật biến có điều kiện; biến này được bật nếu một trong các điều kiện kích hoạt đang bật là đúng trong khi tất cả các điều kiện kích hoạt lượt tắt là sai. Được coi là một tập hợp không theo thứ tự. có thể ghi
formatValue.convertFalseToValue.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
formatValue.convertFalseToValue.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
formatValue.convertFalseToValue.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
formatValue.convertFalseToValue.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
formatValue.convertNullToValue.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
formatValue.convertNullToValue.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
formatValue.convertNullToValue.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
formatValue.convertNullToValue.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
formatValue.convertTrueToValue.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
formatValue.convertTrueToValue.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
formatValue.convertTrueToValue.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
formatValue.convertTrueToValue.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
formatValue.convertUndefinedToValue.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
formatValue.convertUndefinedToValue.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
formatValue.convertUndefinedToValue.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
formatValue.convertUndefinedToValue.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
notes string Ghi chú của người dùng về cách áp dụng biến này trong vùng chứa. có thể ghi
parameter[] list Tham số của biến. 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
scheduleEndMs long Dấu thời gian kết thúc tính bằng mili giây để lên lịch cho biến. 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 biến. 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 biến 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.