Method: properties.audienceLists.list

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

מבוא לרשימות קהלים עם דוגמאות זמינות במאמר יצירה של רשימת קהלים.

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

בקשת 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