Method: advertisers.audit

Kiểm tra một nhà quảng cáo. Trả về số lượng thực thể đã được sử dụng cho mỗi loại tài nguyên theo nhà quảng cáo đã cung cấp. Các thực thể được sử dụng sẽ được tính vào hạn mức tài nguyên tương ứng. Hãy xem https://support.google.com/displayvideo/answer/6071450.

Yêu cầu HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}:audit

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
advertiserId

string (int64 format)

Bắt buộc. Mã nhận dạng của nhà quảng cáo cần kiểm tra.

Tham số truy vấn

Thông số
readMask

string (FieldMask format)

Không bắt buộc. Các trường cụ thể cần trả về. Nếu bạn không chỉ định mặt nạ, thì tất cả các trường trong giao thức phản hồi sẽ được điền. Các giá trị hợp lệ là:

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho AdvertiserService.AuditAdvertiser.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
Trường
usedLineItemsCount

string (int64 format)

Số lượng mục hàng ĐANG HOẠT ĐỘNG, BỊ TẠM DỪNG và BẢN NHÁP của nhà quảng cáo này. Các mục hàng này được tính vào hạn mức 9999 mục hàng cho mỗi nhà quảng cáo.
usedInsertionOrdersCount

string (int64 format)

Số đơn đặt hàng quảng cáo ĐANG HOẠT ĐỘNG, BỊ TẠM DỪNG và BẢN NHÁP của nhà quảng cáo này. Số đơn đặt hàng quảng cáo này được tính vào hạn mức 9.999 đơn đặt hàng quảng cáo cho mỗi nhà quảng cáo.
usedCampaignsCount

string (int64 format)

Số lượng chiến dịch ĐANG HOẠT ĐỘNG và ĐANG TẠM DỪNG thuộc nhà quảng cáo này. Những chiến dịch này được tính vào hạn mức 9999 chiến dịch cho mỗi nhà quảng cáo.
channelsCount

string (int64 format)

Số lượng kênh được tạo trong nhà quảng cáo này. Những kênh này được tính vào giới hạn 1.000 kênh cho mỗi nhà quảng cáo.
negativelyTargetedChannelsCount

string (int64 format)

Số lượng kênh được nhắm mục tiêu theo tiêu chí phủ định mà nhà quảng cáo này đã tạo. Những kênh được nhắm mục tiêu phủ định này sẽ được tính vào hạn mức 5 kênh được nhắm mục tiêu phủ định cho mỗi nhà quảng cáo.
negativeKeywordListsCount

string (int64 format)

Số lượng danh sách từ khoá phủ định được tạo trong nhà quảng cáo này. Những danh sách từ khoá phủ định này được tính vào hạn mức 20 danh sách từ khoá phủ định cho mỗi nhà quảng cáo.
adGroupCriteriaCount

string (int64 format)

Số lượng tuỳ chọn nhắm mục tiêu riêng lẻ trong các loại tiêu chí nhắm mục tiêu sau đây được chỉ định cho một mục hàng trong nhà quảng cáo này. Các lựa chọn nhắm mục tiêu riêng lẻ này được tính vào hạn mức 4.500.000 lựa chọn nhắm mục tiêu theo nhóm quảng cáo cho mỗi nhà quảng cáo.

Các loại tiêu chí nhắm mục tiêu đủ điều kiện:

  • Kênh, URL, ứng dụng và bộ sưu tập
  • Nhân khẩu học
  • Đối tượng của Google, bao gồm cả đối tượng Chung sở thích, Chung sở thích tuỳ chỉnh và Đối tượng đang cân nhắc mua hàng
  • Nguồn khoảng không quảng cáo
  • Từ khóa
  • Danh mục ứng dụng dành cho thiết bị di động
  • Danh sách người dùng
  • Nhắm mục tiêu video
  • Khả năng xem
campaignCriteriaCount

string (int64 format)

Số lượng tuỳ chọn nhắm mục tiêu riêng lẻ từ các loại nhắm mục tiêu sau được chỉ định cho một mục hàng của nhà quảng cáo này. Các tùy chọn nhắm mục tiêu riêng lẻ này được tính vào giới hạn 900.000 tùy chọn nhắm mục tiêu chiến dịch cho mỗi nhà quảng cáo.

Các loại tiêu chí nhắm mục tiêu đủ điều kiện:

  • Vị trí
  • Trình duyệt
  • Tốc độ kết nối
  • Ngày và giờ
  • Thiết bị và hệ điều hành
  • Nhãn nội dung kỹ thuật số
  • Danh mục nhạy cảm
  • Môi trường
  • Vị trí địa lý, bao gồm cả chuỗi doanh nghiệp và khoảng cách
  • ISP (bộ xử lý tín hiệu hình ảnh)
  • Ngôn ngữ
  • Xác minh của bên thứ ba

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.