승인 필요
GTM 매크로를 업데이트합니다. 지금 사용해 보기 또는 예시를 확인하세요.
요청
HTTP 요청
PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/macros/macroId
매개변수
| 매개변수 이름 | 값 | 설명 |
|---|---|---|
| 경로 매개변수 | ||
accountId |
string |
GTM 계정 ID입니다. |
containerId |
string |
GTM 컨테이너 ID입니다. |
macroId |
string |
GTM 매크로 ID입니다. |
| 선택적 쿼리 매개변수 | ||
fingerprint |
string |
제공되는 경우 이 디지털 지문은 저장소에 있는 매크로의 디지털 지문과 일치해야 합니다. |
승인
이 요청을 처리하려면 다음 범위의 승인을 받아야 합니다 (인증 및 승인 자세히 알아보기).
| 범위 |
|---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
요청 본문
요청 본문에 다음과 같은 속성을 사용하여 매크로 리소스를 제공합니다.
| 속성 이름 | 값 | 설명 | Notes |
|---|---|---|---|
| 필수 속성 | |||
parameter[].type |
string |
매개변수 유형. 유효한 값은 다음과 같습니다.
사용 가능한 값은 다음과 같습니다.
|
쓰기 가능 |
type |
string |
GTM 매크로 유형입니다. | 쓰기 가능 |
| 선택적 속성 | |||
disablingRuleId[] |
list |
모바일 컨테이너에만 해당: 조건부 매크로를 사용 중지하기 위한 규칙 ID 목록입니다. 사용 설정 규칙 중 하나가 true이고 모든 사용 중지 규칙이 false인 경우 매크로가 사용 설정됩니다. 순서가 지정되지 않은 집합으로 처리됩니다. | 쓰기 가능 |
enablingRuleId[] |
list |
모바일 컨테이너에만 해당: 조건부 매크로를 사용 설정하기 위한 규칙 ID 목록입니다. 사용 설정 규칙 중 하나가 true이고 모든 사용 중지 규칙이 false인 경우 매크로가 사용 설정됩니다. 순서가 지정되지 않은 집합으로 처리됩니다. | 쓰기 가능 |
name |
string |
매크로 표시 이름입니다. | 쓰기 가능 |
notes |
string |
사용자가 컨테이너에서 이 매크로를 적용하는 방법에 대한 메모. | 쓰기 가능 |
parameter[] |
list |
매크로의 매개변수입니다. | 쓰기 가능 |
parameter[].key |
string |
매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. | 쓰기 가능 |
parameter[].list[] |
list |
이 목록 매개변수의 매개변수입니다 (키는 무시됨). | 쓰기 가능 |
parameter[].map[] |
list |
이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). | 쓰기 가능 |
parameter[].value |
string |
지정된 유형에 적합한 매개변수의 값('"와 같은 매크로 참조를 포함할 수 있음) | 쓰기 가능 |
scheduleEndMs |
long |
매크로를 예약할 종료 타임스탬프(밀리초)입니다. | 쓰기 가능 |
scheduleStartMs |
long |
매크로를 예약할 시작 타임스탬프(밀리초)입니다. | 쓰기 가능 |
응답
요청에 성공할 경우 이 메서드는 응답 본문에 Macros 리소스를 반환합니다.
예
참고: 이 메서드에 제공되는 코드 예시가 지원되는 모든 프로그래밍 언어를 나타내는 것은 아닙니다. 지원되는 언어 목록은 클라이언트 라이브러리 페이지를 참조하세요.
Java
자바 클라이언트 라이브러리를 사용합니다.
/*
* Note: This code assumes you have an authorized tagmanager service object.
*/
/*
* This request updates an existing macro for the authorized user.
*/
// Construct the macro object.
Macro macro = new Macro();
macro.setName("Updated URL Macro");
macro.setType("u");
// Construct the parameters.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("component");
arg0.setValue("URL");
Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("customUrlSource");
arg1.setValue("{{element}}");
// set the parameters on the macro.
macro.setParameter(Arrays.asList(arg0, arg1));
try {
Macro response = tagmanager.accounts().containers().
macros().update("123456", "54321", "18", macro).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
Python 클라이언트 라이브러리를 사용합니다.
# Note: This code assumes you have an authorized tagmanager service object.
# This request updates an existing macro for the authorized user.
try:
response = tagmanager.accounts().containers().macros().update(
accountId='123456',
containerId='54321',
macroId='19',
body={
'name': 'Sample URL Macro',
'type': 'u',
'parameter': [
{
'type': 'template',
'key': 'component',
'value': 'URL'
},
{
'type': 'template',
'key': 'customUrlSource',
'value': '{{element}}'
}
]
}
).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')
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.