Method: advertisers.audit

Kiểm tra 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 thuộc nhà quảng cáo được cung cấp. Các thực thể được sử dụng sẽ đượ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/v5/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

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 không có mặt nạ nào được chỉ định, thì tất cả các trường trong phản hồi proto 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 đầy đủ 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 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, ĐÃ 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 giới hạn 9.999 mục hàng cho mỗi nhà quảng cáo.
usedInsertionOrdersCount

string (int64 format)

Số lượng đơn đặt hàng quảng cáo ĐANG HOẠT ĐỘNG, ĐÃ TẠM DỪNG và BẢN NHÁP 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 giới hạn 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à ĐÃ 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 được tạo trong nhà quảng cáo này. Các 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 trong 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 đượ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 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 tiêu chí 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 thuộc 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 giới hạn 4.500.000 tiêu chí nhắm mục tiêu của 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 Đối tượng chung sở thích, Đối tượng chung sở thích tùy chỉnh và Đối tượng có ý định 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 tiêu chí 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 thuộc 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 giới hạn 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
  • Địa lý, bao gồm cả doanh nghiệp kinh doanh theo chuỗi và khoảng cách địa lý
  • ISP (bộ xử lý tín hiệu hình ảnh)
  • Ngôn ngữ
  • Xác minh 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 OAuth 2.0 Overview.