Method: properties.audienceLists.list

רשימה של כל רשימות הקהלים בנכס. אפשר להשתמש בשיטה הזו כדי למצוא רשימות קיימות של קהלים ולעשות בהן שימוש חוזר, במקום ליצור רשימות חדשות של קהלים שלא נחוצות. לאותו קהל יכולות להיות כמה רשימות קהלים שמייצגות את רשימת המשתמשים שהיו בקהל בימים שונים.

במאמר יצירת רשימת קהלים מוסבר על רשימות קהלים ומפורטות דוגמאות.

השיטה הזו זמינה ביציבות בטא בכתובת audienceExports.list. כדי לשלוח משוב על ה-API הזה, אפשר למלא את הטופס משוב על Google Analytics Audience Export API.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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