Method: advertisers.audit

Kiểm tra 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ể đã sử dụng được tính vào giới hạn 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/v2/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 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 tên đủ điều kiện của các trường đượ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 AdvertisingService.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ố mục hàng ĐANG HOẠT ĐỘNG, ĐANG TẠM DỪNG và BẢN ĐỒ RANH 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ố lượng đơn đặt hàng chèn ĐANG HOẠT ĐỘNG, ĐANG TẠM DỪNG và ĐANG SOẠN của nhà quảng cáo này. Những đơn đặt hàng quảng cáo này được tính vào hạn mức 9999 đơ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à TẠM DỪNG của nhà quảng cáo này. Những chiến dịch này được tính vào giới hạn 9.999 chiến dịch cho mỗi nhà quảng cáo.
channelsCount

string (int64 format)

Số lượng kênh đã tạo mà nhà quảng cáo này đã tạo. 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 được nhắm mục tiêu phủ định đã tạo cho nhà quảng cáo này. 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. Những lựa chọn nhắm mục tiêu riêng lẻ này được tính vào giới hạn 4500.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 lựa 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 tiêu chí nhắm mục tiêu riêng lẻ này được tính vào hạn mức 900.000 tiêu chí nhắm mục tiêu của 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.