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

새 버전으로 이전

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

사용 중인 API 버전이 지원 중단된 경우 이전해야 합니다. 새 버전으로 업데이트해야 합니다 이 가이드에서는 사용 중인 API 버전이 지원 중단되었는지 확인하는 방법에 대해 알아보고 권장되는 이전 단계를 확인하세요.

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

지원 중단된 버전을 사용하는 것으로 의심되는 애플리케이션을 유지관리하는 경우 Campaign Manager 360 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);
```

자바

Java용 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을 통해 배포됩니다.

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

자바

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

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

PHP

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

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

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

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

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

이 시점에서 출시 노트를 검토해야 합니다. 출시 노트를 처음 검토한 버전 (이전 섹션에서 기록한 버전)의 다음 버전부터 업그레이드하려는 버전까지 진행해야 합니다. 출시 노트의 섹션은 다음과 같이 해석해야 합니다.

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

새로운 기능의 기능은 코드 변경이 필요하지 않으므로 지금은 무시해도 됩니다. 추가된 기능을 실험하고 싶으면 나중에 이 섹션을 다시 방문하면 됩니다.

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

새 버전으로 이전

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

Apps Script 새 편집기

Apps Script 기존 편집기

C#

자바

PHP

Python

Ruby

2단계: 버전 상태 확인

3단계: 버전 업그레이드하기

Apps Script 새 편집기

Apps Script 기존 편집기

C#

자바

PHP

Python

Ruby

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

최신 소식 받기