Chuyển sang phiên bản mới

Các phiên bản mới của Campaign Manager 360 API được phát hành thường xuyên. Khi các phiên bản mới được phát hành, các phiên bản cũ sẽ ngừng hoạt động và cuối cùng là ngừng cung cấp. Khi một phiên bản ngừng hoạt động, tất cả các yêu cầu đối với phiên bản đó sẽ bắt đầu trả về lỗi.

Nếu đang dùng phiên bản không được dùng nữa, bạn phải nâng cấp càng sớm càng tốt để tránh bị gián đoạn dịch vụ.

Bước 1: Xác định phiên bản bạn đang sử dụng

Bạn có thể xác định phiên bản API mà mình đang dùng bằng các hướng dẫn sau. Trong hầu hết trường hợp, bạn sẽ truy cập vào API bằng một trong các thư viện ứng dụng dành riêng cho ngôn ngữ hoặc một chế độ tích hợp chính thức.

Trình chỉnh sửa mới của Apps Script

Thông tin phiên bản của Apps Script xuất hiện trong hộp thoại dịch vụ nâng cao:

  1. Trong trình chỉnh sửa Apps Script, hãy nhấp vào Thêm dịch vụ .
  2. Tìm Campaign Manager 360 API trong danh sách các dịch vụ có sẵn.
  3. Giá trị được chọn trong trình đơn thả xuống phiên bản là phiên bản API Campaign Manager 360 đang được sử dụng.

Trình chỉnh sửa cũ của Apps Script

Thông tin phiên bản của Apps Script xuất hiện trong hộp thoại dịch vụ nâng cao:

  1. Trong trình chỉnh sửa Apps Script, hãy chuyển đến Tài nguyên > Các dịch vụ nâng cao của Google.
  2. Tìm Campaign Manager 360 API trong danh sách các dịch vụ có sẵn.
  3. Giá trị được chọn trong trình đơn thả xuống phiên bản là phiên bản API Campaign Manager 360 đang được sử dụng.

C#

Thông tin về phiên bản của Thư viện ứng dụng API của Google cho .NET được hiển thị ở những nơi sau:

  1. Có trong tên gói NuGet và không gian tên dịch vụ. 
    Google.Apis.Dfareporting.v3_4
  2. Được hiển thị bằng thuộc tính công khai của DfareportingService. 
    Console.WriteLine(DfareportingService.Version);

Java

Thông tin về phiên bản của Thư viện ứng dụng Java cho API của Google được hiển thị ở những nơi sau:

  1. Được chỉ định trong Maven artifactId. 
    <dependency> <groupId>com.google.apis</groupId>
<artifactId>google-api-services-dfareporting</artifactId>
<version>v3.4-rev1-1.21.0</version>
</dependency>
  2. Có trong tên tệp JAR. 
    google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
  3. Được hiển thị bằng thuộc tính công khai của Dfareporting. 
    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

Thông tin về phiên bản của Thư viện ứng dụng API của Google cho PHP được hiển thị bằng cách sử dụng một thuộc tính công khai của Google_Service_Dfareporting: 

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

Python

Thư viện ứng dụng API của Google cho Python (phiên bản 1/phiên bản 2) không được phân phiên bản. Phiên bản API cần dùng được chỉ định làm đối số cho trình tạo khám phá: 

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

Ruby

Thư viện ứng dụng Google API cho Ruby phiên bản < 0.9 không được phân phiên bản. Phiên bản API cần dùng được chỉ định làm đối số cho hàm khởi tạo dịch vụ: 

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

Đối với Thư viện ứng dụng API của Google cho các phiên bản Ruby >= 0.9, phiên bản được hiển thị trong không gian tên dịch vụ: 

Google.Apis.DfareportingV3_4

Bước 2: Xác định trạng thái của phiên bản

Kiểm tra lịch ngừng cung cấp để xác định trạng thái của phiên bản. Nếu phiên bản của bạn không có trong danh sách, thì phiên bản đó đã ngừng hoạt động và không còn được hỗ trợ.

Nếu phiên bản của bạn có trong danh sách, hãy kiểm tra các cột Ngày ngừng sử dụng và Ngày ngừng hoạt động:

  • Nếu không có ngày nào, thì phiên bản của bạn được hỗ trợ đầy đủ.
  • Nếu có ngày, thì phiên bản của bạn không dùng được nữa và sẽ ngừng hoạt động vào ngày được chỉ định.

Nếu phiên bản của bạn đã lỗi thời hoặc ngừng hoạt động, bạn cần di chuyển sang phiên bản mới hơn để tránh bị gián đoạn dịch vụ. Bạn nên di chuyển sang phiên bản gần đây nhất có trong lịch trình (không bao gồm các bản phát hành beta) để tối đa hoá thời gian giữa các lần nâng cấp.

Bước 3: Nâng cấp phiên bản

Để di chuyển sang phiên bản mới hơn của API, bạn sẽ cần cập nhật chế độ tích hợp hoặc lấy bản dựng mới nhất của thư viện ứng dụng mà bạn muốn dùng. Xin lưu ý rằng mặc dù một số thư viện ứng dụng có thể cung cấp một bản dựng duy nhất hoạt động với mọi phiên bản API, nhưng những thư viện khác sẽ có các bản dựng riêng cho từng phiên bản. Danh sách sau đây cung cấp thông tin chung về việc nâng cấp cho các thư viện và hoạt động tích hợp ứng dụng khách được sử dụng rộng rãi nhất.

Trình chỉnh sửa mới của Apps Script

Google Apps Script hỗ trợ tất cả các phiên bản của Campaign Manager 360 API và cho phép bạn chọn phiên bản cần sử dụng theo từng tập lệnh. Cách thay đổi phiên bản mà một tập lệnh cụ thể sử dụng:

  1. Trong trình chỉnh sửa Apps Script, hãy nhấp vào Thêm dịch vụ .
  2. Tìm Campaign Manager 360 API trong danh sách các dịch vụ có sẵn.
  3. Thay đổi phiên bản Campaign Manager 360 API bằng trình đơn thả xuống phiên bản.
  4. Nhấp vào Thêm để lưu các thay đổi.

Trình chỉnh sửa cũ của Apps Script

Google Apps Script hỗ trợ tất cả các phiên bản của Campaign Manager 360 API và cho phép bạn chọn phiên bản cần sử dụng theo từng tập lệnh. Cách thay đổi phiên bản mà một tập lệnh cụ thể sử dụng:

  1. Trong trình chỉnh sửa Apps Script, hãy chuyển đến Tài nguyên > Các dịch vụ nâng cao của Google.
  2. Tìm Campaign Manager 360 API trong danh sách các dịch vụ có sẵn.
  3. Thay đổi phiên bản Campaign Manager 360 API bằng trình đơn thả xuống phiên bản.
  4. Nhấp vào OK để lưu các thay đổi.

C#

Thư viện ứng dụng Google API cho .NET cung cấp các bản dựng riêng biệt cho từng phiên bản của Campaign Manager 360 API, được phân phối thông qua NuGet. Cập nhật lên phiên bản thư viện ứng dụng tương ứng với phiên bản API mà bạn muốn sử dụng.

Để biết hướng dẫn chi tiết về cách cài đặt hoặc các lựa chọn tải xuống khác, hãy tham khảo tài liệu về thư viện ứng dụng.

Java

Thư viện ứng dụng Google API cho Java cung cấp các bản dựng riêng biệt cho từng phiên bản của Campaign Manager 360 API, được phân phối thông qua Maven. Cập nhật lên phiên bản thư viện ứng dụng tương ứng với phiên bản API mà bạn muốn sử dụng.

Để biết hướng dẫn chi tiết về cách cài đặt hoặc các lựa chọn tải xuống khác, hãy tham khảo tài liệu về thư viện ứng dụng.

PHP

Thư viện ứng dụng Google API cho PHP cung cấp các bản dựng riêng biệt cho từng phiên bản của Campaign Manager 360 API, được phân phối thông qua Packagist. Cập nhật lên phiên bản thư viện ứng dụng tương ứng với phiên bản API mà bạn muốn sử dụng.

Để biết hướng dẫn chi tiết về cách cài đặt hoặc các lựa chọn tải xuống khác, hãy tham khảo tài liệu về thư viện ứng dụng.

Python

Mọi bản dựng của Thư viện ứng dụng API của Google cho Python (phiên bản 1/phiên bản 2) đều hỗ trợ tất cả các phiên bản của Campaign Manager 360 API. Để di chuyển sang phiên bản mới của Campaign Manager 360 API, hãy cập nhật chuỗi phiên bản được truyền dưới dạng đối số cho trình tạo khám phá: 

discovery.build('dfareporting', 'v3.4', http=http)
 Để biết hướng dẫn chi tiết về cách cài đặt hoặc các lựa chọn tải xuống khác, hãy tham khảo tài liệu về thư viện ứng dụng.

Ruby

Thư viện ứng dụng Google API cho Ruby phiên bản 0.8 trở xuống hỗ trợ tất cả các phiên bản của Campaign Manager 360 API. Để di chuyển sang phiên bản mới của Campaign Manager 360 API, hãy cập nhật chuỗi phiên bản được truyền dưới dạng đối số cho hàm khởi tạo dịch vụ: 

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
 Thư viện ứng dụng Google API cho Ruby phiên bản 0.9 trở lên cung cấp các bản dựng riêng biệt cho từng phiên bản của API Campaign Manager 360, được phân phối thông qua RubyGems. Cập nhật lên phiên bản thư viện ứng dụng tương ứng với phiên bản API mà bạn muốn sử dụng. Để biết hướng dẫn chi tiết về cách cài đặt hoặc các lựa chọn tải xuống khác, hãy tham khảo tài liệu về thư viện ứng dụng.

REST

Nếu bạn đang gọi API trực tiếp bằng HTTPS, hãy cập nhật điểm cuối cho các yêu cầu của bạn để sử dụng số phiên bản API mới.

Ví dụ: khi di chuyển từ v4 sang v5, bạn sẽ thay đổi URL cơ sở từ: 

https://dfareporting.googleapis.com/dfareporting/v4/...
 đến: 
https://dfareporting.googleapis.com/dfareporting/v5/...

Bước 4: Giải quyết các điểm khác biệt về phiên bản

Các phiên bản API mới được thiết kế để tương thích ngược bất cứ khi nào có thể. Tuy nhiên, một số bản cập nhật có thể bao gồm các thay đổi có thể gây lỗi và yêu cầu bạn sửa đổi mã. Những thay đổi này được trình bày chi tiết trong ghi chú phát hành.

Khi di chuyển, hãy xem kỹ ghi chú phát hành của từng phiên bản giữa phiên bản hiện tại và phiên bản mà bạn đang nâng cấp. Hãy đặc biệt chú ý đến các phần sau:

  • Tính năng mới: Chức năng mới được thêm vào. Bạn không cần thay đổi mã để di chuyển.
  • Ngừng hoạt động: Chức năng bị xoá khỏi API. Chức năng thay thế sẽ được ghi chú khi có.
  • Vấn đề đã biết: Sửa đổi chức năng hiện có, chẳng hạn như đổi tên các trường hoặc phương thức, hoặc thay đổi logic xác thực.

Nếu ứng dụng của bạn sử dụng chức năng có trong phần Ngừng hoạt động hoặc Vấn đề đã biết, bạn cần cập nhật mã để giải quyết những thay đổi này.

Nắm bắt thông tin

Thường xuyên theo dõi blog dành cho nhà phát triển Google Ads để là người đầu tiên biết về các bản phát hành, việc ngừng sử dụng và ngừng cung cấp API.