- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- AudienceRow
- AudienceDimensionValue
- ลองใช้งาน
เรียกข้อมูลการส่งออกกลุ่มเป้าหมายของผู้ใช้ หลังจากสร้างกลุ่มเป้าหมายแล้ว ผู้ใช้จะส่งออกไม่ได้ในทันที ขั้นแรก ต้องส่งคำขอไปยัง audienceExports.create
เพื่อสร้างการส่งออกกลุ่มเป้าหมายของผู้ใช้ และขั้นตอนที่ 2 ใช้วิธีการนี้เพื่อเรียกข้อมูลผู้ใช้ในการส่งออกกลุ่มเป้าหมาย
ดูการสร้างการส่งออกกลุ่มเป้าหมายสำหรับข้อมูลเบื้องต้นเกี่ยวกับการส่งออกกลุ่มเป้าหมายพร้อมตัวอย่าง
กลุ่มเป้าหมายใน Google Analytics 4 ช่วยให้คุณแบ่งกลุ่มผู้ใช้ในรูปแบบที่สําคัญต่อธุรกิจได้ ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/analytics/answer/9267572
Audience Export API มีบางเมธอดในรุ่นอัลฟ่าและวิธีอื่นๆ ที่ความเสถียรแบบเบต้า เป้าหมายคือเพื่อพัฒนาวิธีการต่างๆ เพื่อให้มีความเสถียรในรุ่นเบต้า หลังจากมีการแสดงความคิดเห็นและนำไปปรับใช้ หากต้องการแสดงความคิดเห็นเกี่ยวกับ API นี้ โปรดกรอกแบบฟอร์มความคิดเห็นเกี่ยวกับ API การส่งออกกลุ่มเป้าหมายของ Google Analytics
คำขอ HTTP
POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
name |
ต้องระบุ ชื่อของกลุ่มเป้าหมายที่ส่งออกเพื่อดึงผู้ใช้ รูปแบบ: |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "offset": string, "limit": string } |
ช่อง | |
---|---|
offset |
ไม่บังคับ จำนวนแถวของแถวเริ่มต้น แถวแรกจะนับเป็นแถว 0 เมื่อแบ่งหน้า คำขอแรกไม่ได้ระบุออฟเซ็ต หรือเทียบเท่า ตั้งค่าออฟเซ็ตเป็น 0 คำขอแรกแสดงผล ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การใส่เลขหน้านี้ได้ที่การใส่เลขหน้า |
limit |
ไม่บังคับ จำนวนแถวที่จะแสดงผล หากไม่ระบุ ระบบจะแสดงผล 10,000 แถว API จะส่งกลับจำนวนแถวสูงสุด 250,000 แถวต่อคำขอ ไม่ว่าคุณจะขอข้อมูลจำนวนเท่าใดก็ตาม นอกจากนี้ API อาจแสดงผลแถวน้อยกว่า ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การใส่เลขหน้านี้ได้ที่การใส่เลขหน้า |
เนื้อหาการตอบกลับ
รายชื่อผู้ใช้ในการส่งออกกลุ่มเป้าหมาย
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "audienceRows": [ { object ( |
ช่อง | |
---|---|
audienceRows[] |
แถวของผู้ใช้แต่ละรายในการส่งออกกลุ่มเป้าหมาย จำนวนแถวในคำตอบนี้จะน้อยกว่าหรือเท่ากับขนาดหน้าของคำขอ |
audienceExport |
ข้อมูลการกําหนดค่าเกี่ยวกับการส่งออกกลุ่มเป้าหมายที่กําลังค้นหา แสดงผลเพื่อช่วยตีความแถวกลุ่มเป้าหมายในคำตอบนี้ ตัวอย่างเช่น มิติข้อมูลในการส่งออกกลุ่มเป้าหมายนี้จะสอดคล้องกับคอลัมน์ในแถวกลุ่มเป้าหมาย |
rowCount |
จำนวนแถวทั้งหมดในผลลัพธ์การส่งออกกลุ่มเป้าหมาย ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การใส่เลขหน้านี้ได้ที่การใส่เลขหน้า |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
AudienceRow
แอตทริบิวต์ค่ามิติข้อมูลสำหรับแถวผู้ใช้ของกลุ่มเป้าหมาย
การแสดง JSON |
---|
{
"dimensionValues": [
{
object ( |
ช่อง | |
---|---|
dimensionValues[] |
แอตทริบิวต์ค่ามิติข้อมูลแต่ละรายการสำหรับผู้ใช้กลุ่มเป้าหมาย ระบบจะเพิ่มค่ามิติข้อมูล 1 ค่าสำหรับแต่ละคอลัมน์มิติข้อมูลที่ขอ |
AudienceDimensionValue
ค่าของมิติข้อมูล
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม one_value ค่ามิติข้อมูล 1 ค่า one_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
value |
ค่าเป็นสตริง ถ้าประเภทมิติข้อมูลเป็นสตริง |