이 페이지는 Cloud Translation API를 통해 번역되었습니다.

새 버전으로 이전

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

사용 중인 API 버전이 지원 중단된 경우 예정된 서비스 종료 날짜 이전에 최신 버전으로 마이그레이션해야 합니다. 이 가이드에서는 사용 중인 API 버전이 지원 중단되었는지 확인하는 방법과 권장 이전 단계를 제공합니다.

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

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

Apps Script 새 편집기

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

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

Apps Script 기존 편집기

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

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

C#

.NET용 Google API 클라이언트 라이브러리의 버전 정보는 다음 위치에 나와 있습니다.

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

자바

자바용 Google API 클라이언트 라이브러리의 버전 정보는 다음 위치에 나와 있습니다.

maven artifactId에 지정되어 있습니다.

<dependency>
  <groupId>com.google.apis</groupId>
  <artifactId>google-api-services-dfareporting</artifactId>
  <version>v3.4-rev1-1.21.0</version>
</dependency>

JAR 파일 이름에 포함됩니다.

google-api-services-dfareporting-v3.4-rev1-1.21.0.jar

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 클라이언트 라이브러리에는 버전이 지정되지 않습니다. 사용할 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단계: 버전 상태 확인

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

지원 중단 날짜와 서비스 종료 날짜 열에 날짜가 없다면 완전히 지원되는 버전을 사용 중인 것입니다.
날짜가 표시되면 사용 중인 버전이 현재 지원 중단되었으며 지정된 날짜에 서비스가 종료됩니다.
사용 중인 버전이 목록에 없다면 이미 서비스가 중단되어 더 이상 지원되지 않는 것입니다.

위의 2번 또는 3번에 해당하는 경우 서비스가 중단되지 않도록 최신 버전으로 이전해야 합니다. 지원 중단 일정 표의 맨 위에 있는 최신 버전 (베타 출시 제외)으로 이전하는 것이 좋습니다. 이렇게 하면 업그레이드 사이의 최대 시간을 확보할 수 있습니다.

3단계: 버전 업그레이드

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

Apps Script 새 편집기

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

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

Apps Script 기존 편집기

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

C#

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

자세한 설치 안내 또는 대체 다운로드 옵션을 알아보려면 클라이언트 라이브러리 문서를 참조하세요.

자바

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

자세한 설치 안내 또는 대체 다운로드 옵션을 알아보려면 클라이언트 라이브러리 문서를 참조하세요.

PHP

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

자세한 설치 안내 또는 대체 다운로드 옵션을 알아보려면 클라이언트 라이브러리 문서를 참조하세요.

Python

Python용 Google API 클라이언트 라이브러리의 모든 빌드는 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 v0.9+용 Google API 클라이언트 라이브러리는 RubyGems를 통해 배포된 Campaign Manager 360 API의 각 버전에 별도의 빌드를 제공합니다. 자세한 설치 안내 또는 대체 다운로드 옵션을 알아보려면 클라이언트 라이브러리 문서를 참조하세요.

4단계: 버전 차이 해결하기

Google에서는 새 버전이 이전 버전과 호환되도록 하기 위해 노력하고 있습니다. 즉, API 버전 간에 이전해도 코드를 변경할 필요가 없습니다. 이러한 변경이 불가능한 경우 출시 노트에 개발자의 조치가 필요한 변경사항 (브레이킹 체인지라고도 함)이 공지됩니다.

이제 출시 노트를 검토하여 이전 버전부터 시작한 버전부터 시작하여 업그레이드하려는 버전까지의 출시 노트를 검토해야 합니다. 출시 노트의 섹션은 다음과 같이 해석해야 합니다.

새로운 기능 - 새로 추가된 기능입니다.
서비스 종료 - API에서 삭제된 기능입니다. 해당하는 경우 이 섹션에서 대체 기능을 다룹니다.
알려진 문제 - 추가되거나 삭제되지 않은 변경사항입니다. 예를 들어 이 섹션에서는 이름이 변경된 필드 또는 메서드 또는 변경된 유효성 검사 로직을 다룰 수 있습니다.

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

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

새 버전으로 이전

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

Apps Script 새 편집기

Apps Script 기존 편집기

C#

자바

PHP

Python

Ruby

2단계: 버전 상태 확인

3단계: 버전 업그레이드

Apps Script 새 편집기

Apps Script 기존 편집기

C#

자바

PHP

Python

Ruby

4단계: 버전 차이 해결하기

최신 소식 받아 보기