- คำขอ 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 | 
 จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขอให้นำออก รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |