Containers: update

승인 필요

컨테이너를 업데이트합니다. 지금 사용해 보기 또는 예시를 확인하세요.

요청

HTTP 요청

PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId

매개변수

매개변수 이름 설명
경로 매개변수
accountId string GTM 계정 ID입니다.
containerId string GTM 컨테이너 ID입니다.
선택적 쿼리 매개변수
fingerprint string 제공되는 경우 이 디지털 지문은 저장소에 있는 컨테이너의 디지털 지문과 일치해야 합니다.

승인

이 요청을 처리하려면 다음 범위의 승인을 받아야 합니다 (인증 및 승인 자세히 알아보기).

범위
https://www.googleapis.com/auth/tagmanager.edit.containers

요청 본문

요청 본문에서는 다음과 같은 속성을 사용하여 컨테이너 리소스를 제공합니다.

속성 이름 설명 Notes
필수 속성
usageContext[] list 컨테이너의 사용 컨텍스트 목록입니다. 유효한 값은 web, android, ios입니다. 쓰기 가능
선택적 속성
domainName[] list 컨테이너와 연결된 도메인 이름의 선택적 목록입니다. 쓰기 가능
enabledBuiltInVariable[] list 사용 설정된 기본 제공 변수의 목록 유효한 값은 pageUrl, pageHostname, pagePath, referrer, event, clickElement, clickClasses, clickId, clickTarget, clickUrl, clickText, formElement, formClasses, formId, formTarget, formUrl, formText, errorMessage, errorUrl, errorLine, newHistoryFragment, oldHistoryFragment, newHistoryState, oldHistoryState, historySource, containerVersion, debugMode, randomNumber, containerId입니다. 쓰기 가능
name string 컨테이너 표시 이름입니다. 쓰기 가능
notes string 컨테이너 메모 쓰기 가능
timeZoneCountryId string 컨테이너 국가 ID입니다. 쓰기 가능
timeZoneId string 컨테이너 시간대 ID입니다. 쓰기 가능

응답

요청에 성공할 경우 이 메서드는 응답 본문에 컨테이너 리소스를 반환합니다.

참고: 이 메서드에 제공되는 코드 예시가 지원되는 모든 프로그래밍 언어를 나타내는 것은 아닙니다. 지원되는 언어 목록은 클라이언트 라이브러리 페이지를 참조하세요.

Java

자바 클라이언트 라이브러리를 사용합니다.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request updates an existing container for the authorized user.
 */

// Construct the container object.
Container container = new Container();
container.setName("Example Container");
container.setNotes("Example Container Notes.");
container.setTimeZoneCountryId("US");
container.setTimeZoneId("America/Los_Angeles");
container.setUsageContext(Arrays.asList("web", "android", "ios"));

try {
  Container response = tagmanager.accounts().
      containers().update("123456", "54321", container).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 container.
try:
  response = tagmanager.accounts().containers().update(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Example Container',
          'timeZoneCountryId': 'US',
          'timeZoneId': 'America/Los_Angeles',
          'usageContext': ['web', 'android']
      }
  ).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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.