Cần có sự cho phép
Cập nhật thẻ GTM. Thử ngay hoặc xem ví dụ.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags/tagId
Các tham số
| Tên thông số | Giá trị | Nội dung mô tả |
|---|---|---|
| Tham số đường dẫn | ||
accountId |
string |
Mã tài khoản GTM. |
containerId |
string |
Mã vùng chứa Trình quản lý thẻ của Google (GTM). |
tagId |
string |
Mã thẻ GTM. |
| 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 uỷ quyền với phạm vi sau (đọc thêm về quy trình xác thực và uỷ quyền).
| Phạm vi |
|---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
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 | |||
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à:
Các giá trị được chấp nhận là:
|
có thể ghi |
priority.type |
string |
Loại tham số. Các giá trị hợp lệ là:
Các giá trị được chấp nhận là:
|
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 |
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 |
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 |
Đúng nếu thẻ bị tạm dừng. | 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 |
type |
string |
Loại thẻ GTM. | 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.
Ví dụ
Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).
Java
Sử dụng thư viện ứng dụng Java.
/*
* Note: This code assumes you have an authorized tagmanager service object.
*/
/*
* This request updates an existing tag for the authorized user.
*/
// Construct the parameters.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("trackingId");
arg0.setValue("UA-123456-1");
Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("type");
arg1.setValue("TRACK_TRANSACTION");
// Construct the tag object.
Tag tag = new Tag();
tag.setName("Sample Universal Analytics");
tag.setType("ua");
tag.setLiveOnly(false);
tag.setParameter(Arrays.asList(arg0, arg1));
try {
Tag response = tagmanager.accounts().
containers().tags().update("123456", "54321", "1", tag).execute();
} catch (GoogleJsonResponseException e) {
System.err.println("There was a service error: "
+ e.getDetails().getCode() + " : "
+ e.getDetails().getMessage());
}
/*
* The results of the update method are stored in the response object.
* The following code shows how to access the updated name and fingerprint.
*/
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());
Python
Dùng thư viện ứng dụng Python.
# Note: This code assumes you have an authorized tagmanager service object.
# This request updates an existing new container tag.
try:
response = tagmanager.accounts().containers().tags().update(
accountId='123456',
containerId='54321',
tagId='1',
body={
'name': 'Universal Analytics Tag',
'type': 'ua',
'liveOnly': False,
'parameter': [
{
'type': 'template',
'key': 'trackingId',
'value': 'UA-123456-1'
},
{
'type': 'template',
'key': 'type',
'value': 'TRACK_TRANSACTION'
}
]
}
).execute()
except TypeError, error:
# Handle errors in constructing a query.
print 'There was an error in constructing your query : %s' % error
except HttpError, error:
# Handle API errors.
print ('There was an API error : %s : %s' %
(error.resp.status, error.resp.reason))
# The results of the update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')
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.