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