Câu hỏi thường gặp

Giải pháp chung

Phiên bản mới nhất của API là gì?

Phiên bản mới nhất của API mà tài liệu này xử lý là v3.

Tôi có thể truy xuất dữ liệu hiệu suất bằng API này không?

Không. Hãy sử dụng API Trình quản lý giá thầu để tạo, truy xuất và chạy báo cáo ngoại tuyến Display & Video 360.

Sử dụng API

Tôi sử dụng URL nào để truy cập API?

https://displayvideo.googleapis.com

Những phương pháp xác thực nào được hỗ trợ?

OAuth 2.0 là phương pháp xác thực duy nhất được hỗ trợ.

Các yêu cầu API Display & Video 360 phải được uỷ quyền cho phạm vi sau:

  • https://www.googleapis.com/auth/display-video

Các yêu cầu đến dịch vụ users cũng phải được uỷ quyền cho phạm vi bổ sung sau đây:

  • https://www.googleapis.com/auth/display-video-user-management

Tôi muốn viết mã. Tôi có thể tìm thấy thư viện ứng dụng ở đâu?

Tham khảo hướng dẫn về thư viện ứng dụng.

Nếu tôi không muốn sử dụng thư viện ứng dụng thì sao?

Bạn nên sử dụng một trong các thư viện ứng dụng của chúng tôi nhưng cũng có thể tương tác với API Display & Video 360 bằng cách sử dụng các yêu cầu HTTP trực tiếp.

Một số phương thức có liên quan, chẳng hạn như advertisers.assets.upload và media.upload, sẽ khó chuyển đổi trực tiếp sang các yêu cầu HTTP. Xem ví dụ về yêu cầu HTTP cho các phương pháp này bằng cách sử dụng cURL trong hướng dẫn Mẫu quảng cáo và Đặt giá thầu tuỳ chỉnh.

Tôi cần có những quyền nào đối với Display & Video 360?

Để sử dụng API Display & Video 360, Tài khoản Google xác thực phải là người dùng Display & Video 360 có quyền truy cập vào các đối tác hoặc nhà quảng cáo có liên quan.

Người dùng Display & Video 360 phải có một trong các vai trò người dùng sau đây để các đối tác hoặc nhà quảng cáo có liên quan thực hiện những hành động sau:

  • Chỉ đọc: Truy xuất tài nguyên bằng cách sử dụng lệnh gọi get hoặc list, ngoại trừ tài nguyên user.
  • Chuẩn: Truy xuất, tạo và cập nhật tài nguyên. Truy xuất tài nguyên user có quyền cho cùng đối tác hoặc nhà quảng cáo.
  • Quản trị: Truy xuất, tạo và cập nhật tài nguyên. Truy xuất, tạo và cấp quyền truy cập vào các tài nguyên user cho các đối tác hoặc nhà quảng cáo mà bạn quản trị.

Làm cách nào để cập nhật tài nguyên của YouTube và Đối tác bằng API?

API Display & Video 360 không hỗ trợ việc tạo hoặc cập nhật các tài nguyên của YouTube và Đối tác. Tạo hoặc cập nhật hàng loạt tài nguyên của YouTube và Đối tác bằng cách tải Tệp dữ liệu có cấu trúc (SDF) lên trong giao diện Display & Video 360. Để biết thêm thông tin về cách sử dụng tính năng tải lên SDF, hãy đọc trang hướng dẫn của chúng tôi về các tài nguyên của YouTube và Đối tác.

Làm cách nào để nhắm mục tiêu theo vị trí địa lý?

Bạn có thể chỉ định tiêu chí nhắm mục tiêu theo địa lý cho các mục hàng bằng cách sử dụng các kiểu nhắm mục tiêu sau:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Truy xuất mã tuỳ chọn nhắm mục tiêu cho 3 loại nhắm mục tiêu đầu tiên bằng cách sử dụng targetingTypes.targetingOptions.search. Truy xuất và quản lý tài nguyên của danh sách vị trí bằng dịch vụ advertisers.locationLists.

Ngoài ra, bạn cũng có thể tạo mã tuỳ chọn nhắm mục tiêu TARGETING_TYPE_POI để trực tiếp nhắm mục tiêu bán kính vùng lân cận xung quanh các toạ độ kinh độ – vĩ độ cụ thể.

Tôi thấy rằng mình có thể tải Tệp dữ liệu có cấu trúc (SDF) xuống bằng API, nhưng làm cách nào để tải các tệp này lên?

API Display & Video 360 không hỗ trợ tải lên SDF. Bạn nên quản lý tài nguyên thông qua các phương thức CREATE, PATCH và DELETE do API cung cấp. Nếu vẫn muốn quản lý tài nguyên bằng SDF, bạn có thể cập nhật các tệp đó trong giao diện Display & Video 360.

Hỗ trợ

API này có gặp vấn đề hay hạn chế nào đã biết không?

Có giới hạn về số lượng yêu cầu mà dự án của bạn có thể thực hiện mỗi giây, như được nêu trong hướng dẫn về giới hạn sử dụng của chúng tôi.