Method: properties.audienceLists.list

แสดงรายการกลุ่มเป้าหมายทั้งหมดของพร็อพเพอร์ตี้ คุณสามารถใช้วิธีนี้เพื่อค้นหาและนํารายการกลุ่มเป้าหมายที่มีอยู่มาใช้ซ้ำแทนการสร้างรายการกลุ่มเป้าหมายใหม่ที่ไม่จําเป็น กลุ่มเป้าหมายเดียวกันอาจมีรายการกลุ่มเป้าหมายหลายรายการที่แสดงรายการผู้ใช้ที่อยู่ในกลุ่มเป้าหมายในวันต่างๆ

ดูข้อมูลเบื้องต้นเกี่ยวกับรายการกลุ่มเป้าหมายพร้อมตัวอย่างได้ที่การสร้างรายการกลุ่มเป้าหมาย

วิธีการนี้พร้อมใช้งานในเวอร์ชันเบต้าที่ audienceExports.list หากต้องการแสดงความคิดเห็นเกี่ยวกับ API นี้ โปรดกรอกแบบฟอร์มความคิดเห็นเกี่ยวกับ Audience Export API ของ Google Analytics

คำขอ HTTP

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ รายการกลุ่มเป้าหมายทั้งหมดของพร็อพเพอร์ตี้นี้จะแสดงในการตอบกลับ รูปแบบ: properties/{property}

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

ไม่บังคับ จํานวนรายการกลุ่มเป้าหมายสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงรายการกลุ่มเป้าหมายไม่เกิน 200 รายการ ค่าสูงสุดคือ 1,000 (ระบบจะบังคับค่าที่สูงกว่าให้เท่ากับค่าสูงสุด)
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ audienceLists.list ก่อนหน้านี้ ระบุข้อมูลนี้เพื่อเรียกข้อมูลหน้าถัดไป

เมื่อแบ่งหน้าเว็บ พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ audienceLists.list ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "audienceLists": [
    {
      object (AudienceList)
    }
  ],
  "nextPageToken": string
}
ช่อง
audienceLists[]

object (AudienceList)

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

string

โทเค็น ซึ่งสามารถส่งเป็น pageToken เพื่อเรียกข้อมูลหน้าถัดไป หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics