Method: properties.audienceExports.list

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

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

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

בקשת HTTP

GET https://analyticsdata.googleapis.com/v1beta/{parent=properties/*}/audienceExports

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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

string

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

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

גוף הבקשה

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

גוף התשובה

רשימה של כל הייצוא של קהלים בנכס.

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

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

object (AudienceExport)

כל ייצוא של קהל בנכס.
nextPageToken

string

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

היקפי הרשאה

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

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