- คำขอ HTTP
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- RequestStatusPerDestination
- RequestStatus
- ErrorInfo
- ErrorCount
- ProcessingErrorReason
- WarningInfo
- WarningCount
- ProcessingWarningReason
- IngestAudienceMembersStatus
- IngestUserDataStatus
- MatchRateRange
- IngestMobileDataStatus
- IngestPairDataStatus
- IngestEventsStatus
- RemoveAudienceMembersStatus
- RemoveUserDataStatus
- RemoveMobileDataStatus
- RemovePairDataStatus
- ลองใช้งาน
รับสถานะของคำขอที่ระบุรหัสคำขอ
คำขอ HTTP
GET https://datamanager.googleapis.com/v1/requestStatus:retrieve
URL ใช้ไวยากรณ์การแปลงรหัส gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
requestId |
ต้องระบุ ต้องระบุ รหัสคำขอของคำขอ Data Manager API |
เนื้อความของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
คำตอบจาก RetrieveRequestStatusRequest
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"requestStatusPerDestination": [
{
object ( |
ช่อง | |
---|---|
requestStatusPerDestination[] |
รายการสถานะคำขอต่อปลายทาง ลำดับของสถานะจะตรงกับลำดับของปลายทางในคำขอเดิม |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/datamanager
RequestStatusPerDestination
สถานะคำขอต่อปลายทาง
การแสดง JSON |
---|
{ "destination": { object ( |
ช่อง | |
---|---|
destination |
ปลายทางภายในคำขอ DM API |
requestStatus |
สถานะคำขอของปลายทาง |
errorInfo |
ข้อผิดพลาดเกี่ยวกับข้อมูลข้อผิดพลาดที่มีเหตุผลของข้อผิดพลาดและจำนวนข้อผิดพลาดที่เกี่ยวข้องกับการอัปโหลด |
warningInfo |
ข้อมูลคำเตือนที่มีเหตุผลของคำเตือนและจำนวนคำเตือนที่เกี่ยวข้องกับการอัปโหลด |
ฟิลด์ Union status สถานะของปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
audienceMembersIngestionStatus |
สถานะของคำขอสมาชิกในกลุ่มเป้าหมายที่ส่ง |
eventsIngestionStatus |
สถานะของคำขอเหตุการณ์การส่งผ่านข้อมูล |
audienceMembersRemovalStatus |
สถานะของคำขอให้นำสมาชิกของกลุ่มเป้าหมายออก |
RequestStatus
สถานะคำขอ
Enum | |
---|---|
REQUEST_STATUS_UNKNOWN |
ไม่ทราบสถานะคำขอ |
SUCCESS |
คำขอสำเร็จ |
PROCESSING |
คำขออยู่ระหว่างดำเนินการ |
FAILED |
คำขอล้มเหลว |
PARTIAL_SUCCESS |
คำขอสำเร็จบางส่วน |
ErrorInfo
จํานวนข้อผิดพลาดสําหรับข้อผิดพลาดแต่ละประเภท
การแสดง JSON |
---|
{
"errorCounts": [
{
object ( |
ช่อง | |
---|---|
errorCounts[] |
รายการข้อผิดพลาดและจำนวนตามเหตุผลของข้อผิดพลาด อาจไม่แสดงในบางกรณี |
ErrorCount
จำนวนข้อผิดพลาดสำหรับเหตุผลของข้อผิดพลาดที่ระบุ
การแสดง JSON |
---|
{
"recordCount": string,
"reason": enum ( |
ช่อง | |
---|---|
recordCount |
จำนวนระเบียนที่อัปโหลดไม่สำเร็จเนื่องจากสาเหตุที่ระบุ |
reason |
เหตุผลของข้อผิดพลาดของระเบียนที่ไม่สำเร็จ |
ProcessingErrorReason
เหตุผลของข้อผิดพลาดในการประมวลผล
Enum | |
---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
ไม่ทราบสาเหตุของข้อผิดพลาดในการประมวลผล |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
ตัวแปรที่กำหนดเองไม่ถูกต้อง |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
ไม่ได้เปิดใช้สถานะของตัวแปรที่กำหนดเอง |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
Conversion เก่ากว่าอายุสูงสุดที่รองรับ |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
ผู้ใช้ปฏิเสธข้อมูลผู้ใช้ของโฆษณา ไม่ว่าจะเป็นโดยผู้ใช้หรือในการตั้งค่าเริ่มต้นของผู้ลงโฆษณา |
PROCESSING_ERROR_REASON_NO_CONSENT |
ผู้ลงโฆษณาไม่ได้ให้ความยินยอมแก่บุคคลที่สามสำหรับบริการแพลตฟอร์มหลักของโฆษณา |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
ไม่สามารถระบุความยินยอมโดยรวม (พิจารณาจากความยินยอมระดับแถว ความยินยอมระดับคำขอ และการตั้งค่าบัญชี) สำหรับผู้ใช้รายนี้ |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
มี Conversion ที่มี GCLID และเวลาที่เกิด Conversion เดียวกันนี้อยู่ในระบบแล้ว |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
มีการอัปโหลด Conversion ที่มีชุดค่าผสมรหัสคำสั่งซื้อและการกระทำที่ถือเป็น Conversion เดียวกันแล้ว |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
ถอดรหัส gbraid ไม่ได้ |
PROCESSING_ERROR_REASON_INVALID_GCLID |
ไม่สามารถถอดรหัส Google Click ID |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
รหัสผู้ขายมีอักขระที่ไม่ใช่ตัวเลข |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
ไม่สามารถถอดรหัส wbraid |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
ข้อผิดพลาดภายใน |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
ไม่ได้ลงนามในข้อกำหนดของ Conversion ที่ปรับปรุงแล้วในบัญชีปลายทาง |
PROCESSING_ERROR_REASON_INVALID_EVENT |
กิจกรรมไม่ถูกต้อง |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
ธุรกรรมที่ตรงกันมีจำนวนน้อยกว่าเกณฑ์ขั้นต่ำ |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
ธุรกรรมมีมูลค่าน้อยกว่าเกณฑ์ขั้นต่ำ |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
กิจกรรมมีข้อผิดพลาดเกี่ยวกับรูปแบบ |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
กิจกรรมมีข้อผิดพลาดในการถอดรหัส |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
ถอดรหัส DEK ไม่สำเร็จ |
PROCESSING_ERROR_REASON_INVALID_WIP |
WIP มีการจัดรูปแบบไม่ถูกต้องหรือไม่มี WIP |
PROCESSING_ERROR_REASON_INVALID_KEK |
KEK ถอดรหัสข้อมูลไม่ได้เนื่องจากเป็น KEK ที่ไม่ถูกต้องหรือไม่พบ |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
ใช้ WIP ไม่ได้เนื่องจากเงื่อนไขการรับรองปฏิเสธ |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
ระบบไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง KEK |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
ถอดรหัสข้อมูล UserIdentifier โดยใช้ DEK ไม่สำเร็จ |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
ผู้ใช้พยายามส่งเหตุการณ์ที่มีตัวระบุโฆษณาซึ่งไม่ได้มาจากโฆษณาของบัญชีปฏิบัติการ |
WarningInfo
จำนวนคำเตือนสำหรับคำเตือนแต่ละประเภท
การแสดง JSON |
---|
{
"warningCounts": [
{
object ( |
ช่อง | |
---|---|
warningCounts[] |
รายการคำเตือนและจำนวนคำเตือนตามเหตุผลของคำเตือน |
WarningCount
จำนวนคำเตือนสำหรับเหตุผลของคำเตือนที่ระบุ
การแสดง JSON |
---|
{
"recordCount": string,
"reason": enum ( |
ช่อง | |
---|---|
recordCount |
จำนวนระเบียนที่มีคำเตือน |
reason |
เหตุผลของคำเตือน |
ProcessingWarningReason
เหตุผลของคำเตือนการประมวลผล
Enum | |
---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
ไม่ทราบสาเหตุของคำเตือนเกี่ยวกับการประมวลผล |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
ระบบไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง KEK |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
ถอดรหัส DEK ไม่สำเร็จ |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
กิจกรรมมีข้อผิดพลาดในการถอดรหัส |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
ใช้ WIP ไม่ได้เนื่องจากเงื่อนไขการรับรองปฏิเสธ |
PROCESSING_WARNING_REASON_INVALID_WIP |
WIP มีการจัดรูปแบบไม่ถูกต้องหรือไม่มี WIP |
PROCESSING_WARNING_REASON_INVALID_KEK |
KEK ถอดรหัสข้อมูลไม่ได้เนื่องจากเป็น KEK ที่ไม่ถูกต้องหรือไม่พบ |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
ถอดรหัสข้อมูล UserIdentifier ไม่สำเร็จโดยใช้ DEK |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
ข้อผิดพลาดภายใน |
IngestAudienceMembersStatus
สถานะของคำขอสมาชิกในกลุ่มเป้าหมายที่ส่ง
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์ Union status สถานะการส่งข้อมูลสมาชิกในกลุ่มเป้าหมายไปยังปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
userDataIngestionStatus |
สถานะการนำเข้าข้อมูลผู้ใช้ไปยังปลายทาง |
mobileDataIngestionStatus |
สถานะการนำเข้าข้อมูลมือถือไปยังปลายทาง |
pairDataIngestionStatus |
สถานะของการนำเข้าข้อมูลคู่ไปยังปลายทาง |
IngestUserDataStatus
สถานะของการนำเข้าข้อมูลผู้ใช้ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า
การแสดง JSON |
---|
{
"recordCount": string,
"userIdentifierCount": string,
"uploadMatchRateRange": enum ( |
ช่อง | |
---|---|
recordCount |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
userIdentifierCount |
จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
uploadMatchRateRange |
ช่วงอัตราการจับคู่ของการอัปโหลด |
MatchRateRange
ช่วงอัตราการจับคู่ของการอัปโหลดหรือกลุ่มเป้าหมายตามข้อมูลผู้ใช้
Enum | |
---|---|
MATCH_RATE_RANGE_UNKNOWN |
ไม่ทราบช่วงอัตราการจับคู่ |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
ช่วงอัตราการจับคู่ไม่มีสิทธิ์ |
MATCH_RATE_RANGE_LESS_THAN_20 |
ช่วงอัตราการจับคู่น้อยกว่า 20% (ในช่วง [0, 20) ) |
MATCH_RATE_RANGE_20_TO_30 |
ช่วงอัตราการจับคู่อยู่ระหว่าง 20% ถึง 30% (ในช่วง [20, 31) ) |
MATCH_RATE_RANGE_31_TO_40 |
ช่วงอัตราการจับคู่อยู่ระหว่าง 31% ถึง 40% (ในช่วง [31, 41) ) |
MATCH_RATE_RANGE_41_TO_50 |
ช่วงอัตราการจับคู่อยู่ระหว่าง 41% ถึง 50% (ในช่วง [41, 51) ) |
MATCH_RATE_RANGE_51_TO_60 |
ช่วงอัตราการจับคู่อยู่ระหว่าง 51% ถึง 60% (ในระยะเวลา [51, 61) |
MATCH_RATE_RANGE_61_TO_70 |
ช่วงอัตราการจับคู่อยู่ระหว่าง 61% ถึง 70% (ในช่วง [61, 71) ) |
MATCH_RATE_RANGE_71_TO_80 |
ช่วงอัตราการจับคู่อยู่ระหว่าง 71% ถึง 80% (ในช่วง [71, 81) ) |
MATCH_RATE_RANGE_81_TO_90 |
ช่วงอัตราการจับคู่อยู่ระหว่าง 81% ถึง 90% (ในช่วง [81, 91) ) |
MATCH_RATE_RANGE_91_TO_100 |
ช่วงอัตราการจับคู่อยู่ระหว่าง 91% ถึง 100% (ในช่วง |
IngestMobileDataStatus
สถานะของการส่งผ่านข้อมูลอินเทอร์เน็ตมือถือไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการส่งผ่านข้อมูล
การแสดง JSON |
---|
{ "recordCount": string, "mobileIdCount": string } |
ช่อง | |
---|---|
recordCount |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
mobileIdCount |
จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
IngestPairDataStatus
สถานะของการนำเข้าข้อมูลคู่ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า
การแสดง JSON |
---|
{ "recordCount": string, "pairIdCount": string } |
ช่อง | |
---|---|
recordCount |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
pairIdCount |
จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
IngestEventsStatus
สถานะของการส่งผ่านข้อมูลเหตุการณ์ไปยังปลายทาง
การแสดง JSON |
---|
{ "recordCount": string } |
ช่อง | |
---|---|
recordCount |
จํานวนเหตุการณ์ทั้งหมดที่ส่งในคําขออัปโหลด รวมเหตุการณ์ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
RemoveAudienceMembersStatus
สถานะของคำขอให้นำสมาชิกของกลุ่มเป้าหมายออก
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์ Union status สถานะของการนำสมาชิกกลุ่มเป้าหมายออกจากปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
userDataRemovalStatus |
สถานะการนำข้อมูลผู้ใช้ออกจากปลายทาง |
mobileDataRemovalStatus |
สถานะการนำข้อมูลในอุปกรณ์เคลื่อนที่ออกจากปลายทาง |
pairDataRemovalStatus |
สถานะการนำข้อมูลคู่ที่นำออกจากปลายทาง |
RemoveUserDataStatus
สถานะการนำข้อมูลผู้ใช้ออกจากปลายทาง
การแสดง JSON |
---|
{ "recordCount": string, "userIdentifierCount": string } |
ช่อง | |
---|---|
recordCount |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
userIdentifierCount |
จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขอให้นำออก รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
RemoveMobileDataStatus
สถานะการนำข้อมูลในอุปกรณ์เคลื่อนที่ออกจากปลายทาง
การแสดง JSON |
---|
{ "recordCount": string, "mobileIdCount": string } |
ช่อง | |
---|---|
recordCount |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
mobileIdCount |
จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขอลบ รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
RemovePairDataStatus
สถานะการนำข้อมูลคู่ที่นำออกจากปลายทาง
การแสดง JSON |
---|
{ "recordCount": string, "pairIdCount": string } |
ช่อง | |
---|---|
recordCount |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
pairIdCount |
จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขอให้นำออก รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |