Method: advertisers.audit

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

Yêu cầu HTTP

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

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

Tham số đường dẫn

Các tham 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

Các tham số
readMask

string (FieldMask format)

Không bắt buộc. Các trường cụ thể cần trả về. Nếu không chỉ định mặt nạ nào, thì tất cả trường trong proto 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

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:

Thông báo phản hồi cho advertiserService.AdvertiserAdvertiser.

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
}
Các trường
usedLineItemsCount

string (int64 format)

Số mục hàng ĐANG HOẠT ĐỘNG, BỊ TẠM DỪNG và BẢN NHÁP trong nhà quảng cáo này. Các mục hàng này được tính vào giới hạn 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, TẠM DỪNG và BẢN NHÁP trong nhà quảng cáo này. Số đơn đặt hàng quảng cáo này được tính vào giới hạn 9.999 đơn đặt hàng quảng cáo của mỗi nhà quảng cáo.
usedCampaignsCount

string (int64 format)

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

string (int64 format)

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

string (int64 format)

Số lượng kênh nhắm mục tiêu phủ định được tạo trong nhà quảng cáo này. Những kênh nhắm mục tiêu phủ định này được tính vào hạn mức 5 kênh 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 đã tạo trong nhà quảng cáo này. Các 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 tùy chọn nhắm mục tiêu riêng lẻ từ các loại nhắm mục tiêu sau đây đượ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 4500.000 tùy chọn nhắm mục tiêu nhóm quảng cáo cho mỗi nhà quảng cáo.

Loại nhắm mục tiêu đủ điều kiện:

  • Kênh, URL, ứng dụng và bộ sưu tập
  • Thông tin nhân khẩu học
  • Đối tượng của Google, bao gồm đối tượng chung sở thích, đối tượng 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ừ khoá
  • 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 tùy chọn nhắm mục tiêu riêng lẻ từ các loại nhắm mục tiêu sau đây được chỉ định cho một mục hàng của nhà quảng cáo này. Các tuỳ chọn nhắm mục tiêu riêng lẻ này được tính vào giới hạn 900.000 tuỳ chọn nhắm mục tiêu chiến dịch cho mỗi nhà quảng cáo.

Loại 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
  • Khu vực địa lý, bao gồm cả chuỗi doanh nghiệp và vùng lân cận
  • 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 Tổng quan về OAuth 2.0.