새 버전으로 이전

Campaign Manager 360 API의 새 버전이 정기적으로 출시됩니다. 새 버전이 출시되면 이전 버전은 지원 중단되고 결국 지원 종료됩니다. 버전의 지원이 종료되면 해당 버전에 대한 모든 요청에서 오류가 반환되기 시작합니다.

사용 중인 API 버전이 지원 중단되는 경우 예정된 지원 종료일 전에 최신 버전으로 이전해야 합니다. 이 가이드에서는 사용 중인 API 버전이 지원 중단되었는지 확인하는 방법을 자세히 설명하고 권장되는 이전 단계를 제공합니다.

1단계: 사용 중인 버전 확인하기

지원 중단된 버전의 Campaign Manager 360 API를 사용하고 있을 것으로 의심되는 애플리케이션을 유지 관리하는 경우 먼저 사용 중인 버전을 확인해야 합니다. 대부분의 경우 Google의 언어별 클라이언트 라이브러리 중 하나 또는 공식 통합을 통해 API에 액세스합니다. 이러한 클라이언트 라이브러리 및 통합에서 사용 중인 API 버전을 찾는 방법은 다음과 같습니다.

Apps Script의 새로운 편집기

Apps Script의 버전 정보는 고급 서비스 대화상자에 노출됩니다.

  1. Apps Script 편집기에서 서비스 추가 를 클릭합니다.
  2. 사용 가능한 서비스 목록에서 Campaign Manager 360 API를 찾습니다.
  3. 버전 드롭다운에서 선택한 값은 현재 사용 중인 Campaign Manager 360 API 버전입니다.

Apps Script 기존 편집기

Apps Script의 버전 정보는 고급 서비스 대화상자에 노출됩니다.

  1. Apps Script 편집기에서 리소스 > 고급 Google 서비스로 이동합니다.
  2. 사용 가능한 서비스 목록에서 Campaign Manager 360 API를 찾습니다.
  3. 버전 드롭다운에서 선택한 값은 현재 사용 중인 Campaign Manager 360 API 버전입니다.

C#

.NET용 Google API 클라이언트 라이브러리의 버전 정보는 다음 위치에 노출됩니다.

  1. nuget 패키지 이름 및 서비스 네임스페이스에 포함됩니다. 
    Google.Apis.Dfareporting.v3_4
  2. DfareportingService의 공개 속성을 통해 노출됩니다. 
    Console.WriteLine(DfareportingService.Version);

자바

Java용 Google API 클라이언트 라이브러리의 버전 정보는 다음 위치에 노출됩니다.

  1. Maven 아티팩트 ID에 지정됩니다. 
    <dependency>
  <groupId>com.google.apis</groupId>
  <artifactId>google-api-services-dfareporting</artifactId>
  <version>v3.4-rev1-1.21.0</version>
</dependency>
  2. JAR 파일 이름에 포함됩니다. 
    google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
  3. Dfareporting의 공개 속성을 통해 노출됩니다. 
    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

PHP용 Google API 클라이언트 라이브러리의 버전 정보는 Google_Service_Dfareporting의 공개 속성을 통해 노출됩니다. 

$service = new Google_Service_Dfareporting($client)
print $service->version;

Python

Python용 Google API 클라이언트 라이브러리 (v1/v2)는 버전이 지정되지 않습니다. 사용할 API 버전은 디스커버리 빌더의 인수로 지정됩니다. 

discovery.build('dfareporting', 'v3.4', http=http)

Ruby

Ruby용 Google API 클라이언트 라이브러리 버전 0.9 미만에는 버전이 지정되지 않습니다. 사용할 API 버전은 서비스 생성자의 인수로 지정됩니다. 

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

Ruby용 Google API 클라이언트 라이브러리 버전이 0.9 이상인 경우 버전이 서비스 네임스페이스에 노출됩니다. 

Google.Apis.DfareportingV3_4

나중에 이 정보가 필요하므로 사용 중인 버전을 기록해 둡니다.

2단계: 버전 상태 확인하기

지원 중단 일정에는 현재 지원되는 모든 버전의 상태가 나와 있습니다. 이 목록에서 사용 중인 버전을 찾아 다음과 같이 상태를 확인합니다.

  1. 지원 중단 날짜 및 지원 종료 날짜 열에 날짜가 표시되지 않으면 완전히 지원되는 버전을 사용하고 있는 것입니다.
  2. 날짜가 표시되면 사용 중인 버전이 현재 지원 중단되었으며 지정된 날짜에 지원이 종료됩니다.
  3. 사용 중인 버전이 표에 없으면 이미 지원 중단되었으며 더 이상 지원되지 않습니다.

위의 2번 또는 3번에 해당하는 경우 서비스 중단을 방지하려면 최신 버전으로 이전해야 합니다. 지원 중단 일정 표 상단에 나열된 최신 버전으로 이전하는 것이 좋습니다 (베타 출시 제외). 이렇게 하면 업그레이드 간에 최대한 많은 시간을 확보할 수 있습니다.

3단계: 버전 업그레이드

이전해야 한다고 판단되면 다음 단계는 통합을 업데이트하거나 기본 클라이언트 라이브러리의 업데이트된 빌드를 가져오는 것입니다. 일부 클라이언트 라이브러리는 모든 API 버전에서 작동하는 단일 빌드만 제공할 수 있지만, 다른 라이브러리는 버전별로 별도의 빌드를 보유합니다. 다음 목록은 가장 널리 사용되는 클라이언트 라이브러리 및 통합에 관한 일반적인 업그레이드 정보를 제공합니다.

Apps Script의 새로운 편집기

Google Apps Script는 Campaign Manager 360 API의 모든 버전을 지원하며 스크립트별로 사용할 버전을 선택할 수 있습니다. 특정 스크립트에서 사용하는 버전을 변경하려면 다음 단계를 따르세요.

  1. Apps Script 편집기에서 서비스 추가 를 클릭합니다.
  2. 사용 가능한 서비스 목록에서 Campaign Manager 360 API를 찾습니다.
  3. 버전 드롭다운을 통해 사용 중인 Campaign Manager 360 API 버전을 변경합니다.
  4. 추가를 클릭하여 변경사항을 저장합니다.

Apps Script 기존 편집기

Google Apps Script는 Campaign Manager 360 API의 모든 버전을 지원하며 스크립트별로 사용할 버전을 선택할 수 있습니다. 특정 스크립트에서 사용하는 버전을 변경하려면 다음 단계를 따르세요.

  1. Apps Script 편집기에서 리소스 > 고급 Google 서비스로 이동합니다.
  2. 사용 가능한 서비스 목록에서 Campaign Manager 360 API를 찾습니다.
  3. 버전 드롭다운을 통해 사용 중인 Campaign Manager 360 API 버전을 변경합니다.
  4. 확인을 클릭하여 변경사항을 저장합니다.

C#

.NET용 Google API 클라이언트 라이브러리는 Nuget을 통해 배포되는 Campaign Manager 360 API의 각 버전에 대해 별도의 빌드를 제공합니다.

자세한 설치 안내 또는 대체 다운로드 옵션은 클라이언트 라이브러리 문서를 참고하세요.

자바

Java용 Google API 클라이언트 라이브러리는 Maven을 통해 배포되는 Campaign Manager 360 API의 각 버전에 대해 별도의 빌드를 제공합니다.

자세한 설치 안내 또는 대체 다운로드 옵션은 클라이언트 라이브러리 문서를 참고하세요.

PHP

PHP용 Google API 클라이언트 라이브러리는 Packagist를 통해 배포되는 Campaign Manager 360 API의 각 버전에 대해 별도의 빌드를 제공합니다.

자세한 설치 안내 또는 대체 다운로드 옵션은 클라이언트 라이브러리 문서를 참고하세요.

Python

Python용 Google API 클라이언트 라이브러리 (v1/v2)의 모든 빌드는 모든 버전의 Campaign Manager 360 API를 지원합니다. 탐색 빌더에 인수로 전달되는 버전 문자열을 업데이트하기만 하면 됩니다. 

discovery.build('dfareporting', 'v3.4', http=http)
 자세한 설치 안내 또는 대체 다운로드 옵션은 클라이언트 라이브러리 문서를 참고하세요.

Ruby

Ruby용 Google API 클라이언트 라이브러리 v0.8 이하에서는 모든 버전의 Campaign Manager 360 API를 지원합니다. 서비스 생성자에 인수로 전달되는 버전 문자열을 업데이트하기만 하면 됩니다. 

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
 Ruby용 Google API 클라이언트 라이브러리 v0.9 이상은 RubyGems를 통해 배포되는 Campaign Manager 360 API의 각 버전에 대해 별도의 빌드를 제공합니다. 자세한 설치 안내 또는 대체 다운로드 옵션은 클라이언트 라이브러리 문서를 참고하세요.

4단계: 주소 버전 차이

Google은 새 버전을 하위 호환되도록 노력하고 있습니다. 즉, API 버전 간에 이전할 때 코드를 변경할 필요가 없습니다. 불가능한 경우 개발자의 조치가 필요한 변경사항 (중대한 변경사항이라고도 함)을 출시 노트에 공지합니다.

이 시점에서는 시작 버전 (이전 섹션에서 메모함) 이후 버전부터 업그레이드하려는 버전까지의 출시 노트를 검토해야 합니다. 출시 노트의 섹션은 다음과 같이 해석해야 합니다.

  • 새로운 기능 - 새로 추가된 기능입니다.
  • 지원 중단 - API에서 삭제된 기능입니다. 가능한 경우 이 섹션에서 대체 기능을 설명합니다.
  • 알려진 문제 - 추가 또는 삭제가 아닌 변경사항입니다. 예를 들어 이 섹션에서는 이름이 변경된 필드 또는 메서드 또는 변경된 유효성 검사 로직을 다룰 수 있습니다.

새로운 기능의 기능은 코드 변경이 필요하지 않으며 지금은 무시해도 됩니다. 추가된 기능을 실험해 보려면 언제든지 이 섹션으로 돌아오세요.

반면 지원 종료 또는 알려진 문제 섹션에 변경사항이 있는 경우 조치를 취해야 할 수 있습니다. 코드를 검색하여 삭제되거나 수정된 기능이 애플리케이션에서 사용되는지 확인해야 합니다. 이 경우 이러한 변경사항을 해결하기 위해 코드를 업데이트해야 합니다.

최신 소식 받기

앞서 언급한 대로 Campaign Manager 360 API는 정기적으로 출시 및 지원 중단됩니다. 신규 출시, 지원 중단, 지원 종료에 관한 업데이트는 다음 채널에 게시됩니다.

최신 API 뉴스를 계속 확인하려면 이러한 채널 중 하나 이상을 구독하는 것이 좋습니다.