Method: requestStatus.retrieve

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

string

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 (RequestStatusPerDestination)
    }
  ]
}
Trường
requestStatusPerDestination[]

object (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 (Destination)
  },
  "requestStatus": enum (RequestStatus),
  "errorInfo": {
    object (ErrorInfo)
  },
  "warningInfo": {
    object (WarningInfo)
  },

  // Union field status can be only one of the following:
  "audienceMembersIngestionStatus": {
    object (IngestAudienceMembersStatus)
  },
  "eventsIngestionStatus": {
    object (IngestEventsStatus)
  },
  "audienceMembersRemovalStatus": {
    object (RemoveAudienceMembersStatus)
  }
  // End of list of possible types for union field status.
}
Trường
destination

object (Destination)

Một đích đến trong yêu cầu DM API.

requestStatus

enum (RequestStatus)

Trạng thái yêu cầu của đích đến.

errorInfo

object (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

object (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

object (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ả.

eventsIngestionStatus

object (IngestEventsStatus)

Trạng thái của yêu cầu về sự kiện truyền trực tiếp.

audienceMembersRemovalStatus

object (RemoveAudienceMembersStatus)

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 (ErrorCount)
    }
  ]
}
Trường
errorCounts[]

object (ErrorCount)

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 (ProcessingErrorReason)
}
Trường
recordCount

string (int64 format)

Số lượng bản ghi không tải lên được vì một lý do nào đó.

reason

enum (ProcessingErrorReason)

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_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 (WarningCount)
    }
  ]
}
Trường
warningCounts[]

object (WarningCount)

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 (ProcessingWarningReason)
}
Trường
recordCount

string (int64 format)

Số lượng bản ghi có cảnh báo.

reason

enum (ProcessingWarningReason)

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 status can be only one of the following:
  "userDataIngestionStatus": {
    object (IngestUserDataStatus)
  },
  "mobileDataIngestionStatus": {
    object (IngestMobileDataStatus)
  },
  "pairDataIngestionStatus": {
    object (IngestPairDataStatus)
  }
  // End of list of possible types for union field status.
}
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

object (IngestUserDataStatus)

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

object (IngestMobileDataStatus)

Trạng thái của quá trình nhập dữ liệu di động vào đích đến.

pairDataIngestionStatus

object (IngestPairDataStatus)

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 (MatchRateRange)
}
Trường
recordCount

string (int64 format)

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

string (int64 format)

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

enum (MatchRateRange)

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 [91, 100]).

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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 status can be only one of the following:
  "userDataRemovalStatus": {
    object (RemoveUserDataStatus)
  },
  "mobileDataRemovalStatus": {
    object (RemoveMobileDataStatus)
  },
  "pairDataRemovalStatus": {
    object (RemovePairDataStatus)
  }
  // End of list of possible types for union field status.
}
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

object (RemoveUserDataStatus)

Trạng thái xoá dữ liệu người dùng khỏi đích đến.

mobileDataRemovalStatus

object (RemoveMobileDataStatus)

Trạng thái xoá dữ liệu di động khỏi đích đến.

pairDataRemovalStatus

object (RemovePairDataStatus)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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.