Method: properties.recurringAudienceLists.list

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. כל רשימות הקהלים הקבועות של הנכס הזה יופיעו בתגובה. פורמט: properties/{property}

פרמטרים של שאילתה

פרמטרים
pageSize

integer

זה שינוי אופציונלי. המספר המקסימלי של רשימות קבועות של חברים בקהל שיש להחזיר. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא צוין מספר, המערכת תחזיר עד 200 רשימות קהלים חוזרות. הערך המקסימלי הוא 1,000 (ערכים גבוהים יותר יומרו לערך המקסימלי).
pageToken

string

זה שינוי אופציונלי. אסימון דף, שהתקבל משיחה קודמת של recurringAudienceLists.list. צריך לספק אותו כדי לאחזר את הדף הבא.

כשמחלקים את הדפים, כל שאר הפרמטרים שסופקו ל-recurringAudienceLists.list חייבים להתאים לקריאה שסיפקה את אסימון הדף.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

רשימה של כל רשימות הקהלים הקבועות של נכס.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "recurringAudienceLists": [
    {
      object (RecurringAudienceList)
    }
  ],
  "nextPageToken": string
}
שדות
recurringAudienceLists[]

object (RecurringAudienceList)

כל רשימת קהל קבועה של נכס.
nextPageToken

string

אסימון שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא. אם השדה הזה לא יצוין, לא יהיו דפים נוספים.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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