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ể đượ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

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

Tham 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 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ố 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. Những mục hàng này được tính vào giới hạn 9.999 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à BỊ 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 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 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 được tính vào giới hạn 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 đã tạo cho nhà quảng cáo này. Những danh sách từ khoá phủ định này được tính vào giới hạn 20 danh sách từ khoá phủ định cho mỗi nhà quảng cáo.

adGroupCriteriaCount

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. 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, Đố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ừ 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 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
  • 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 bài viết Tổng quan về OAuth 2.0.