새 버전으로 이전

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

사용 중인 버전이 지원 중단된 경우 서비스 중단을 방지하려면 최대한 빨리 업그레이드해야 합니다.

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

다음 안내에 따라 사용 중인 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 artifactId에 지정됩니다. 
    <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단계: 버전 상태 확인하기

지원 중단 일정을 확인하여 버전의 상태를 확인합니다. 버전이 목록에 없으면 지원이 중단되어 더 이상 지원되지 않는 것입니다.

버전이 나열되어 있으면 지원 중단 날짜 및 서비스 종료 날짜 열을 확인합니다.

  • 날짜가 표시되지 않으면 해당 버전이 완전히 지원되는 것입니다.
  • 날짜가 표시되면 버전이 지원 중단되었으며 지정된 날짜에 지원 종료됩니다.

버전이 지원 중단되었거나 서비스가 종료된 경우 서비스 중단을 방지하려면 최신 버전으로 이전해야 합니다. 업그레이드 간 시간을 최대한 늘리려면 일정에 표시된 최신 버전 (베타 버전 제외)으로 이전하는 것이 좋습니다.

3단계: 버전 업그레이드

최신 버전의 API로 이전하려면 통합을 업데이트하거나 원하는 클라이언트 라이브러리의 업데이트된 빌드를 획득해야 합니다. 일부 클라이언트 라이브러리는 모든 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의 각 버전에 대해 별도의 빌드를 제공합니다. 사용하려는 API 버전에 해당하는 클라이언트 라이브러리 버전으로 업데이트합니다.

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

자바

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

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

PHP

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

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

Python

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

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

Ruby

Ruby용 Google API 클라이언트 라이브러리 v0.8 이하에서는 Campaign Manager 360 API의 모든 버전을 지원합니다. 새 버전의 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의 각 버전에 대해 별도의 빌드를 제공합니다. 사용하려는 API 버전에 해당하는 클라이언트 라이브러리 버전으로 업데이트합니다. 자세한 설치 안내 또는 대체 다운로드 옵션은 클라이언트 라이브러리 문서를 참고하세요.

REST

HTTPS를 사용하여 API를 직접 호출하는 경우 새 API 버전 번호를 사용하도록 요청의 엔드포인트를 업데이트하세요.

예를 들어 v4에서 v5로 이전하는 경우 기본 URL을 다음과 같이 변경합니다. 

https://dfareporting.googleapis.com/dfareporting/v4/...
 다음으로 변경: 
https://dfareporting.googleapis.com/dfareporting/v5/...

4단계: 주소 버전 차이

새 API 버전은 가능한 경우 하위 호환되도록 설계되었습니다. 하지만 일부 업데이트에는 코드를 수정해야 하는 브레이킹 체인지가 포함될 수 있습니다. 이러한 변경사항은 출시 노트에 자세히 설명되어 있습니다.

마이그레이션할 때는 현재 버전과 업그레이드할 버전 사이의 각 버전의 출시 노트를 검토하세요. 다음 섹션에 특히 주의하세요.

  • 새로운 기능: 새로 추가된 기능입니다. 이러한 기능은 이전 시 코드 변경이 필요하지 않습니다.
  • 지원 중단: API에서 삭제된 기능입니다. 대체 기능은 사용 가능한 경우 표시됩니다.
  • 알려진 문제: 필드 또는 메서드의 이름 변경, 유효성 검사 로직 변경 등 기존 기능의 수정사항입니다.

애플리케이션에서 지원 중단 또는 알려진 문제 섹션에 나열된 기능을 사용하는 경우 이러한 변경사항을 해결하도록 코드를 업데이트해야 합니다.

최신 정보 받기

Google Ads 개발자 블로그를 정기적으로 모니터링하여 API 출시, 지원 중단, 서비스 종료에 관한 소식을 가장 먼저 받아보세요.