REST Resource: properties.audienceExports

ทรัพยากร: AudienceExport

การส่งออกกลุ่มเป้าหมายคือรายชื่อผู้ใช้ในกลุ่มเป้าหมาย ณ เวลาที่สร้างรายการ กลุ่มเป้าหมาย 1 กลุ่มอาจมีการส่งออกกลุ่มเป้าหมายหลายรายการที่สร้างในวันต่างๆ

การแสดง JSON
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number
}
ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุ ชื่อทรัพยากรการส่งออกกลุ่มเป้าหมายที่กำหนดไว้ในระหว่างการสร้าง ชื่อทรัพยากรนี้จะระบุ AudienceExport นี้

รูปแบบ: properties/{property}/audienceExports/{audienceExport}

audience

string

ต้องระบุ ชื่อทรัพยากรกลุ่มเป้าหมาย ชื่อทรัพยากรนี้จะระบุกลุ่มเป้าหมายที่แสดงอยู่และแชร์ระหว่าง Analytics Data และ Admin API

รูปแบบ: properties/{property}/audiences/{audience}

audienceDisplayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงที่สื่อความหมายสําหรับกลุ่มเป้าหมายนี้ เช่น "ผู้ซื้อ"

dimensions[]

object (AudienceDimension)

ต้องระบุ มิติข้อมูลที่ขอและแสดงในการตอบกลับการค้นหา

creationQuotaTokensCharged

integer

เอาต์พุตเท่านั้น โทเค็นโควต้าทั้งหมดที่เรียกเก็บในระหว่างการสร้าง AudienceExport เนื่องจากจํานวนโทเค็นนี้อิงตามกิจกรรมจากสถานะ CREATING ระบบจะเรียกเก็บโทเค็นนี้แบบคงที่เมื่อ AudienceExport เข้าสู่สถานะ ACTIVE หรือ FAILED

state

enum (State)

เอาต์พุตเท่านั้น สถานะปัจจุบันของ AudienceExport นี้

beginCreatingTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่มีการเรียกใช้ audienceExports.create และ AudienceExport เริ่มเข้าสู่สถานะ CREATING

การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

rowCount

integer

เอาต์พุตเท่านั้น จํานวนแถวทั้งหมดในผลลัพธ์ AudienceExport

errorMessage

string

เอาต์พุตเท่านั้น ระบบจะแสดงข้อความแสดงข้อผิดพลาดเมื่อการส่งออกกลุ่มเป้าหมายล้มเหลวระหว่างการสร้าง สาเหตุที่พบบ่อยของปัญหานี้คือโควต้าหมด

percentageCompleted

number

เอาต์พุตเท่านั้น เปอร์เซ็นต์การส่งออกกลุ่มเป้าหมายนี้ที่เสร็จสมบูรณ์จะอยู่ระหว่าง 0 ถึง 100

AudienceDimension

มิติข้อมูลกลุ่มเป้าหมายคือแอตทริบิวต์ผู้ใช้ ระบบจะขอการระบุแหล่งที่มาของผู้ใช้ที่เฉพาะเจาะจง แล้วแสดงผลใน QueryAudienceExportResponse ในภายหลัง

การแสดง JSON
{
  "dimensionName": string
}
ช่อง
dimensionName

string

ไม่บังคับ ชื่อ API ของมิติข้อมูล ดูรายการชื่อมิติข้อมูลในมิติข้อมูล API

รัฐ

ปัจจุบัน AudienceExport อยู่ในสถานะนี้

Enum
STATE_UNSPECIFIED ระบบจะไม่ใช้สถานะที่ไม่ระบุ
CREATING ขณะนี้ AudienceExport กําลังสร้าง และจะพร้อมใช้งานในอนาคต การสร้างจะเกิดขึ้นทันทีหลังจากการเรียกใช้ audienceExports.create
ACTIVE AudienceExport สร้างเสร็จสมบูรณ์และพร้อมสําหรับการค้นหาแล้ว ระบบจะอัปเดต AudienceExport เป็น "ใช้งานอยู่" แบบไม่พร้อมกันจากคําขอ ซึ่งจะเกิดขึ้นหลังจากการเรียกใช้การสร้างครั้งแรก (เช่น 15 นาที)
FAILED สร้าง AudienceExport ไม่สำเร็จ การส่งออกกลุ่มเป้าหมายนี้อีกครั้งอาจประสบความสําเร็จ

เมธอด

create

สร้างการส่งออกกลุ่มเป้าหมายเพื่อดึงข้อมูลภายหลัง

get

รับข้อมูลเมตาการกําหนดค่าเกี่ยวกับการส่งออกกลุ่มเป้าหมายที่เฉพาะเจาะจง

list

แสดงรายการการส่งออกกลุ่มเป้าหมายทั้งหมดสําหรับพร็อพเพอร์ตี้

query

ดึงข้อมูลการส่งออกกลุ่มเป้าหมายของผู้ใช้