- Yêu cầu HTTP
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- RequestStatusPerDestination
- RequestStatus
- ErrorInfo
- ErrorCount
- ProcessingErrorReason
- WarningInfo
- WarningCount
- ProcessingWarningReason
- IngestAudienceMembersStatus
- IngestUserDataStatus
- MatchRateRange
- IngestMobileDataStatus
- IngestPairDataStatus
- IngestEventsStatus
- RemoveAudienceMembersStatus
- RemoveUserDataStatus
- RemoveMobileDataStatus
- RemovePairDataStatus
- Hãy làm thử!
Lấy trạng thái của một yêu cầu theo mã yêu cầu đã cho.
Yêu cầu HTTP
GET https://datamanager.googleapis.com/v1/requestStatus:retrieve
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Thông số | |
---|---|
requestId |
Bắt buộc. Bắt buộc. Mã yêu cầu của yêu cầu Data Manager API. |
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
Câu trả lời của RetrieveRequestStatusRequest
.
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 |
---|
{
"requestStatusPerDestination": [
{
object ( |
Trường | |
---|---|
requestStatusPerDestination[] |
Danh sách trạng thái yêu cầu cho mỗi đích đến. Thứ tự của các trạng thái khớp với thứ tự của các đích đến trong yêu cầu ban đầu. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/datamanager
RequestStatusPerDestination
Trạng thái yêu cầu cho mỗi đích đến.
Biểu diễn dưới dạng JSON |
---|
{ "destination": { object ( |
Trường | |
---|---|
destination |
Một đích đến trong yêu cầu DM API. |
requestStatus |
Trạng thái yêu cầu của đích đến. |
errorInfo |
Một lỗi thông tin lỗi chứa lý do lỗi và số lượng lỗi liên quan đến quá trình tải lên. |
warningInfo |
Thông tin cảnh báo chứa lý do cảnh báo và số lượng cảnh báo liên quan đến tệp tải lên. |
Trường nhóm status . Trạng thái của đích đến. status chỉ có thể là một trong những trạng thái sau: |
|
audienceMembersIngestionStatus |
Trạng thái của yêu cầu về việc tiếp nhận hội viên là khán giả. |
eventsIngestionStatus |
Trạng thái của yêu cầu về sự kiện truyền trực tiếp. |
audienceMembersRemovalStatus |
Trạng thái của yêu cầu xoá thành viên khỏi đối tượng. |
RequestStatus
Trạng thái yêu cầu.
Enum | |
---|---|
REQUEST_STATUS_UNKNOWN |
Trạng thái của yêu cầu là không xác định. |
SUCCESS |
Yêu cầu thành công. |
PROCESSING |
Yêu cầu đang được xử lý. |
FAILED |
Yêu cầu không thành công. |
PARTIAL_SUCCESS |
Yêu cầu thành công một phần. |
ErrorInfo
Số lượng lỗi cho từng loại lỗi.
Biểu diễn dưới dạng JSON |
---|
{
"errorCounts": [
{
object ( |
Trường | |
---|---|
errorCounts[] |
Danh sách lỗi và số lượng lỗi theo từng lý do gây ra lỗi. Có thể không được điền sẵn trong một số trường hợp. |
ErrorCount
Số lỗi cho một lý do gây lỗi nhất định.
Biểu diễn dưới dạng JSON |
---|
{
"recordCount": string,
"reason": enum ( |
Trường | |
---|---|
recordCount |
Số lượng bản ghi không tải lên được vì một lý do nào đó. |
reason |
Lý do xảy ra lỗi của các bản ghi không thành công. |
ProcessingErrorReason
Lý do xảy ra lỗi trong quá trình xử lý.
Enum | |
---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
Chưa xác định được lý do gây ra lỗi xử lý. |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
Biến tuỳ chỉnh không hợp lệ. |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
Trạng thái của biến tuỳ chỉnh là chưa bật. |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
Lượt chuyển đổi cũ hơn độ tuổi tối đa được hỗ trợ. |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
Người dùng từ chối dữ liệu người dùng quảng cáo hoặc dữ liệu này bị từ chối trong chế độ cài đặt mặc định của nhà quảng cáo. |
PROCESSING_ERROR_REASON_NO_CONSENT |
Nhà quảng cáo chưa đồng ý cho bên thứ ba sử dụng các dịch vụ nền tảng cốt lõi của Quảng cáo. |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
Không xác định được sự đồng ý tổng thể (xác định từ sự đồng ý ở cấp hàng, sự đồng ý ở cấp yêu cầu và chế độ cài đặt tài khoản) cho người dùng này |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
Đã có một lượt chuyển đổi có cùng GCLID và thời gian chuyển đổi trong hệ thống. |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
Một lượt chuyển đổi có cùng kết hợp mã đơn đặt hàng và hành động chuyển đổi đã được tải lên. |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
Không thể giải mã gbraid. |
PROCESSING_ERROR_REASON_INVALID_GCLID |
Không thể giải mã mã lượt nhấp của Google. |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
Mã người bán chứa các ký tự không phải là chữ số. |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
Không thể giải mã wbraid. |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
Lỗi nội bộ. |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
Bạn chưa ký các điều khoản về tính năng lượt chuyển đổi nâng cao trong tài khoản đích. |
PROCESSING_ERROR_REASON_INVALID_EVENT |
Sự kiện này không hợp lệ. |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
Số giao dịch được so khớp thấp hơn ngưỡng tối thiểu. |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
Các giao dịch này có giá trị thấp hơn ngưỡng tối thiểu. |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
Sự kiện có lỗi định dạng. |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
Sự kiện có lỗi giải mã. |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
Không giải mã được DEK. |
PROCESSING_ERROR_REASON_INVALID_WIP |
WIP có định dạng không chính xác hoặc không tồn tại. |
PROCESSING_ERROR_REASON_INVALID_KEK |
KEK không thể giải mã dữ liệu vì đây là KEK không chính xác hoặc không tồn tại. |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
Không thể sử dụng WIP vì điều kiện chứng thực của WIP đã từ chối. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
Hệ thống không có các quyền cần thiết để truy cập vào KEK. |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Không giải mã được dữ liệu UserIdentifier bằng DEK. |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
Người dùng đã cố gắng truyền các sự kiện bằng một giá trị nhận dạng quảng cáo không phải từ quảng cáo của tài khoản đang hoạt động. |
WarningInfo
Số lượng cảnh báo cho từng loại cảnh báo.
Biểu diễn dưới dạng JSON |
---|
{
"warningCounts": [
{
object ( |
Trường | |
---|---|
warningCounts[] |
Danh sách cảnh báo và số lượng theo từng lý do cảnh báo. |
WarningCount
Số lượng cảnh báo cho một lý do cảnh báo nhất định.
Biểu diễn dưới dạng JSON |
---|
{
"recordCount": string,
"reason": enum ( |
Trường | |
---|---|
recordCount |
Số lượng bản ghi có cảnh báo. |
reason |
Lý do cảnh báo. |
ProcessingWarningReason
Lý do xuất hiện cảnh báo xử lý.
Enum | |
---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
Không xác định được lý do cảnh báo xử lý. |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
Hệ thống không có các quyền cần thiết để truy cập vào KEK. |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
Không giải mã được DEK. |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
Sự kiện có lỗi giải mã. |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
Không thể sử dụng WIP vì điều kiện chứng thực của WIP đã từ chối. |
PROCESSING_WARNING_REASON_INVALID_WIP |
WIP có định dạng không chính xác hoặc không tồn tại. |
PROCESSING_WARNING_REASON_INVALID_KEK |
KEK không thể giải mã dữ liệu vì đây là KEK không chính xác hoặc không tồn tại. |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Không giải mã được dữ liệu UserIdentifier bằng DEK. |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
Lỗi nội bộ. |
IngestAudienceMembersStatus
Trạng thái của yêu cầu về việc tiếp nhận hội viên là khán giả.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường nhóm status . Trạng thái nhập thành viên đối tượng vào đích đến. status chỉ có thể là một trong những trạng thái sau: |
|
userDataIngestionStatus |
Trạng thái của quá trình tiếp nhận dữ liệu người dùng vào đích đến. |
mobileDataIngestionStatus |
Trạng thái của quá trình nhập dữ liệu di động vào đích đến. |
pairDataIngestionStatus |
Trạng thái của quá trình nhập dữ liệu theo cặp vào đích đến. |
IngestUserDataStatus
Trạng thái của quá trình truyền dữ liệu người dùng đến đích đến chứa số liệu thống kê liên quan đến quá trình truyền.
Biểu diễn dưới dạng JSON |
---|
{
"recordCount": string,
"userIdentifierCount": string,
"uploadMatchRateRange": enum ( |
Trường | |
---|---|
recordCount |
Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được tiếp nhận thành công hay không. |
userIdentifierCount |
Tổng số giá trị nhận dạng người dùng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả giá trị nhận dạng người dùng trong yêu cầu, bất kể giá trị đó có được truyền thành công hay không. |
uploadMatchRateRange |
Phạm vi tỷ lệ khớp của nội dung tải lên. |
MatchRateRange
Phạm vi tỷ lệ khớp của tệp tải lên hoặc danh sách người dùng.
Enum | |
---|---|
MATCH_RATE_RANGE_UNKNOWN |
Chưa xác định được phạm vi tỷ lệ trùng khớp. |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
Phạm vi tỷ lệ khớp không đủ điều kiện. |
MATCH_RATE_RANGE_LESS_THAN_20 |
Phạm vi tỷ lệ khớp dưới 20% (trong khoảng [0, 20) ). |
MATCH_RATE_RANGE_20_TO_30 |
Phạm vi tỷ lệ khớp nằm trong khoảng từ 20% đến 30% (trong khoảng [20, 31) ). |
MATCH_RATE_RANGE_31_TO_40 |
Phạm vi tỷ lệ khớp nằm trong khoảng từ 31% đến 40% (trong khoảng [31, 41) ). |
MATCH_RATE_RANGE_41_TO_50 |
Phạm vi tỷ lệ khớp nằm trong khoảng từ 41% đến 50% (trong khoảng [41, 51) ). |
MATCH_RATE_RANGE_51_TO_60 |
Phạm vi tỷ lệ khớp nằm trong khoảng từ 51% đến 60% (trong khoảng [51, 61) . |
MATCH_RATE_RANGE_61_TO_70 |
Tỷ lệ khớp nằm trong khoảng từ 61% đến 70% (trong khoảng [61, 71) ). |
MATCH_RATE_RANGE_71_TO_80 |
Phạm vi tỷ lệ khớp nằm trong khoảng từ 71% đến 80% (trong khoảng [71, 81) ). |
MATCH_RATE_RANGE_81_TO_90 |
Phạm vi tỷ lệ khớp nằm trong khoảng từ 81% đến 90% (trong khoảng [81, 91) ). |
MATCH_RATE_RANGE_91_TO_100 |
Phạm vi tỷ lệ khớp là từ 91% đến 100% (trong khoảng |
IngestMobileDataStatus
Trạng thái của quá trình nhập dữ liệu di động vào đích đến chứa số liệu thống kê liên quan đến quá trình nhập.
Biểu diễn dưới dạng JSON |
---|
{ "recordCount": string, "mobileIdCount": string } |
Trường | |
---|---|
recordCount |
Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được tiếp nhận thành công hay không. |
mobileIdCount |
Tổng số mã nhận dạng thiết bị di động được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả mã nhận dạng thiết bị di động trong yêu cầu, bất kể mã nhận dạng đó có được nhập thành công hay không. |
IngestPairDataStatus
Trạng thái của quá trình nhập dữ liệu cặp vào đích đến chứa số liệu thống kê liên quan đến quá trình nhập.
Biểu diễn dưới dạng JSON |
---|
{ "recordCount": string, "pairIdCount": string } |
Trường | |
---|---|
recordCount |
Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được tiếp nhận thành công hay không. |
pairIdCount |
Tổng số mã nhận dạng theo cặp được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả mã nhận dạng cặp trong yêu cầu, bất kể chúng có được nhập thành công hay không. |
IngestEventsStatus
Trạng thái của việc chuyển đổi sự kiện sang đích đến.
Biểu diễn dưới dạng JSON |
---|
{ "recordCount": string } |
Trường | |
---|---|
recordCount |
Tổng số sự kiện được gửi trong yêu cầu tải lên. Bao gồm tất cả sự kiện trong yêu cầu, bất kể sự kiện đó có được truyền tải thành công hay không. |
RemoveAudienceMembersStatus
Trạng thái của yêu cầu xoá thành viên khỏi đối tượng.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường nhóm status . Trạng thái xoá thành viên đối tượng khỏi đích đến. status chỉ có thể là một trong những trạng thái sau: |
|
userDataRemovalStatus |
Trạng thái xoá dữ liệu người dùng khỏi đích đến. |
mobileDataRemovalStatus |
Trạng thái xoá dữ liệu di động khỏi đích đến. |
pairDataRemovalStatus |
Trạng thái xoá dữ liệu cặp khỏi đích đến. |
RemoveUserDataStatus
Trạng thái xoá dữ liệu người dùng khỏi đích đến.
Biểu diễn dưới dạng JSON |
---|
{ "recordCount": string, "userIdentifierCount": string } |
Trường | |
---|---|
recordCount |
Tổng số thành viên trong đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng trong yêu cầu, bất kể họ có được xoá thành công hay không. |
userIdentifierCount |
Tổng số giá trị nhận dạng người dùng được gửi trong yêu cầu xoá. Bao gồm tất cả giá trị nhận dạng người dùng trong yêu cầu, bất kể chúng có được xoá thành công hay không. |
RemoveMobileDataStatus
Trạng thái xoá dữ liệu di động khỏi đích đến.
Biểu diễn dưới dạng JSON |
---|
{ "recordCount": string, "mobileIdCount": string } |
Trường | |
---|---|
recordCount |
Tổng số thành viên trong đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng trong yêu cầu, bất kể họ có được xoá thành công hay không. |
mobileIdCount |
Tổng số mã nhận dạng thiết bị di động được gửi trong yêu cầu gỡ bỏ. Bao gồm tất cả mã nhận dạng thiết bị di động trong yêu cầu, bất kể mã nhận dạng đó có được xoá thành công hay không. |
RemovePairDataStatus
Trạng thái xoá dữ liệu cặp khỏi đích đến.
Biểu diễn dưới dạng JSON |
---|
{ "recordCount": string, "pairIdCount": string } |
Trường | |
---|---|
recordCount |
Tổng số thành viên trong đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng trong yêu cầu, bất kể họ có được xoá thành công hay không. |
pairIdCount |
Tổng số mã nhận dạng cặp được gửi trong yêu cầu gỡ bỏ. Bao gồm tất cả mã nhận dạng cặp trong yêu cầu, bất kể chúng có được xoá thành công hay không. |