Ads Data Hub API

API để thực thi các truy vấn Trung tâm dữ liệu quảng cáo.

Dịch vụ: adsdatahub.googleapis.com

Để gọi dịch vụ này, bạn nên sử dụng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng của bạn cần sử dụng thư viện của riêng bạn để gọi dịch vụ này, hãy sử dụng thông tin sau khi bạn thực hiện yêu cầu API.

Tài liệu khám phá

Tài liệu khám phá là một bản đặc tả mà máy có thể đọc được để mô tả và sử dụng các API REST. Bạn có thể dùng công cụ này để xây dựng thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác tương tác với các API của Google. Một dịch vụ có thể cung cấp nhiều tài liệu khám phá. Dịch vụ này cung cấp tài liệu khám phá sau:

Điểm cuối dịch vụ

Điểm cuối của dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của một dịch vụ API. Một dịch vụ có thể có nhiều điểm cuối cho dịch vụ. Dịch vụ này có điểm cuối dịch vụ sau đây và tất cả các URI bên dưới đều liên quan đến điểm cuối dịch vụ này:

  • https://adsdatahub.googleapis.com

Tài nguyên REST: v1.customer

Phương pháp
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Mô tả các Mã nhận dạng nhà quảng cáo Display & Video 360 hợp lệ
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Liệt kê các trình so khớp sự kiện hợp lệ cùng với siêu dữ liệu của các trình so khớp đó để tạo danh sách đối tượng giới hạn tần suất.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Xuất nhật ký công việc của một tài khoản khách hàng sang tập dữ liệu BigQuery do khách hàng chọn.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Bắt đầu thực thi một truy vấn để truy xuất các chỉ số về khả năng xem lưu lượng truy cập không hợp lệ cho nền tảng DV360.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Bắt đầu thực thi một truy vấn để truy xuất thông tin tóm tắt từng ngày về số lượng lưu lượng truy cập không hợp lệ cho một nền tảng cụ thể.
get GET /v1/{name=customers/*}
Truy xuất khách hàng Ads Data Hub được yêu cầu.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Trả về tỷ lệ phần trăm dữ liệu trên Google của tất cả khách hàng đã được nhập thành công vào ADH vào ngày cụ thể.
list GET /v1/customers
Liệt kê những khách hàng Ads Data Hub mà người dùng hiện tại có quyền truy cập.

Tài nguyên REST: v1.customer.adsDataCustomer

Phương pháp
get GET /v1/{name=customers/*/adsDataCustomers/*}
Truy xuất khách hàng Ads Data Hub được yêu cầu.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Truy xuất ngân sách truy cập dữ liệu cho nguồn dữ liệu quảng cáo được yêu cầu trong 366 ngày qua.
list GET /v1/{parent=customers/*}/adsDataCustomers
Liệt kê dữ liệu quảng cáo mà khách hàng có thể truy cập.

Tài nguyên REST: v1.customers.AnalysisQueries

Phương pháp
create POST /v1/{parent=customers/*}/analysisQueries
Tạo một truy vấn phân tích để thực thi sau đó.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Xóa cụm từ tìm kiếm.
get GET /v1/{name=customers/*/analysisQueries/*}
Truy xuất truy vấn phân tích được yêu cầu.
list GET /v1/{parent=customers/*}/analysisQueries
Liệt kê các truy vấn phân tích thuộc sở hữu của khách hàng được chỉ định.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Cập nhật truy vấn phân tích hiện có.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Bắt đầu thực thi một truy vấn phân tích đã lưu trữ.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Bắt đầu thực thi trên một truy vấn phân tích tạm thời.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Thực hiện kiểm tra xác thực tĩnh trên truy vấn phân tích được cung cấp.

Tài nguyên REST: v1.customer.customBiddingAlgorithms

Phương pháp
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Thêm một nhà quảng cáo DV360 vào các nhà quảng cáo sử dụng thuật toán đặt giá thầu tuỳ chỉnh.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Tạo thuật toán đặt giá thầu tùy chỉnh do Trung tâm dữ liệu quảng cáo quản lý.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Xoá thuật toán đặt giá thầu tuỳ chỉnh này.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Tính điểm số các lượt hiển thị trong 30 ngày qua đối với các mô hình đặt giá thầu tùy chỉnh.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Truy xuất thuật toán đặt giá thầu tùy chỉnh do Ads Data Hub quản lý.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Liệt kê các thuật toán đặt giá thầu tùy chỉnh do khách hàng Ads Data Hub chỉ định.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
Cập nhật thuật toán đặt giá thầu tùy chỉnh do Ads Data Hub quản lý.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Xoá một nhà quảng cáo DV360 khỏi thuật toán đặt giá thầu tuỳ chỉnh của nhà quảng cáo đó.

Tài nguyên REST: v1.customer.tables

Phương pháp
get GET /v1/{name=customers/*/tables/*}
Truy xuất bảng Trung tâm dữ liệu quảng cáo được yêu cầu.
list GET /v1/{parent=customers/*}/tables
Liệt kê các bảng Ads Data Hub mà khách hàng được chỉ định có quyền truy cập.

Tài nguyên REST: v1.customer.tempTables

Phương pháp
get GET /v1/{name=customers/*/tempTables/*}
Truy xuất bảng tạm thời của Ads Data Hub theo yêu cầu.
list GET /v1/{parent=customers/*}/tempTables
Liệt kê các bảng tạm thời của Ads Data Hub mà khách hàng đã tạo.

Tài nguyên REST: v1.customers.userListQueries

Phương pháp
create POST /v1/{parent=customers/*}/userListQueries
Tạo truy vấn danh sách người dùng để thực thi sau đó.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Xóa truy vấn danh sách người dùng.
get GET /v1/{name=customers/*/userListQueries/*}
Truy xuất truy vấn danh sách người dùng được yêu cầu.
list GET /v1/{parent=customers/*}/userListQueries
Liệt kê các truy vấn danh sách người dùng thuộc sở hữu của khách hàng được chỉ định.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Cập nhật truy vấn danh sách người dùng hiện có.
start POST /v1/{name=customers/*/userListQueries/*}:start
Bắt đầu thực thi đối với một truy vấn danh sách người dùng đã lưu trữ.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Bắt đầu thực thi đối với một truy vấn tạm thời về danh sách người dùng.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Thực hiện kiểm tra xác thực tĩnh trên truy vấn danh sách người dùng được cung cấp.

Tài nguyên REST: v1.customer.userLists

Phương pháp
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Thêm trình so khớp sự kiện vào danh sách người dùng dựa trên tần suất.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Thêm các thực thể vào người nhận của danh sách người dùng do Ads Data Hub quản lý.
create POST /v1/{parent=customers/*}/userLists
Tạo danh sách người dùng do Ads Data Hub quản lý.
delete DELETE /v1/{name=customers/*/userLists/*}
Xóa danh sách người dùng do Ads Data Hub quản lý.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Tạo gói hội viên cho Danh sách người dùng.
get GET /v1/{name=customers/*/userLists/*}
Truy xuất danh sách người dùng do Ads Data Hub quản lý theo yêu cầu.
list GET /v1/{parent=customers/*}/userLists
Liệt kê các danh sách người dùng do khách hàng Ads Data Hub được chỉ định quản lý.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Cập nhật danh sách người dùng do Ads Data Hub quản lý.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Xoá các thực thể khỏi danh sách người nhận của danh sách người dùng do Ads Data Hub quản lý.

Tài nguyên REST: v1.Operas

Phương pháp
cancel POST /v1/{name=operations/**}:cancel
Bắt đầu huỷ không đồng bộ trên một thao tác chạy trong thời gian dài.
delete DELETE /v1/{name=operations/**}
Xoá một thao tác chạy trong thời gian dài.
get GET /v1/{name=operations/**}
Nhận trạng thái mới nhất của một thao tác chạy trong thời gian dài.
list GET /v1/{name}
Liệt kê các thao tác khớp với bộ lọc đã chỉ định trong yêu cầu.
wait POST /v1/{name=operations/**}:wait
Chờ cho đến khi thao tác thực hiện lâu dài được chỉ định thực hiện hoặc đạt tối đa thời gian chờ chỉ định, trả về trạng thái mới nhất.

Tài nguyên REST: v1.outage

Phương pháp
list GET /v1/outages
Liệt kê các trường hợp ngừng dịch vụ theo thứ tự giảm dần của dấu thời gian bắt đầu và thời gian xem lại là 130 ngày.