בתיבת הדו-שיח הזו מפורטים כל רשימות הקהלים שחוזרות על עצמן בנכס מסוים. אפשר להשתמש בשיטה הזאת כדי למצוא רשימות קהלים קיימות שחוזרות על עצמן ולהשתמש בהן שוב, במקום ליצור רשימות קהלים חדשות ומיותרות שחוזרות על עצמן. לאותו קהל יכולות להיות כמה רשימות קהלים חוזרות שמייצגות שילובים שונים של מאפיינים. לדוגמה, רק המאפיין deviceId
או גם המאפיינים deviceId
וגם userId
.
נכון לעכשיו השיטה מבוססת על יציבות אלפא במטרה לקבל משוב על תחביר ויכולות לפני המעבר לבטא. כדי לתת משוב על ה-API הזה, יש למלא את טופס המשוב על Google Analytics Audience Export API.
בקשת HTTP
GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
parent |
חובה. בתשובה יופיעו כל רשימות הקהלים שחוזרות על עצמן בנכס הזה. פורמט: |
פרמטרים של שאילתה
פרמטרים | |
---|---|
pageSize |
זה שינוי אופציונלי. המספר המקסימלי של רשימות קהלים שחוזרות על עצמן. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו לכל היותר 200 רשימות קהלים חוזרות. הערך המקסימלי הוא 1,000 (ערכים גבוהים יותר ייגזרו לערך המקסימלי). |
pageToken |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
רשימה של כל רשימות הקהלים החוזרות בנכס מסוים.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"recurringAudienceLists": [
{
object ( |
שדות | |
---|---|
recurringAudienceLists[] |
כל רשימה חוזרת של חברים בקהל בנכס מסוים. |
nextPageToken |
אסימון, שניתן לשלוח בתור |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics