Method: properties.recurringAudienceLists.list

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

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

בקשת HTTP

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

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