Method: properties.audienceLists.list

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

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

integer

ไม่บังคับ จำนวนรายการกลุ่มเป้าหมายสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลรายการกลุ่มเป้าหมายสูงสุด 200 รายการ ค่าสูงสุดคือ 1000 (ค่าที่สูงกว่าจะถูกเปลี่ยนเป็นค่าสูงสุด)
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