Method: properties.recurringAudienceLists.list

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

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

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