משאב: AudienceExport
ייצוא של קהלים הוא רשימה של המשתמשים בקהל במועד היצירה של הרשימה. לקהל אחד יכול להיות מספר אירועי ייצוא של קהלים שנוצרו עבור ימים שונים.
ייצוג JSON |
---|
{ "name": string, "audience": string, "audienceDisplayName": string, "dimensions": [ { object ( |
שדות | |
---|---|
name |
פלט בלבד. מזהה. שם המשאב של ייצוא הקהלים שהוקצה במהלך היצירה. שם המשאב מזהה את פורמט: |
audience |
חובה. השם של משאב הקהל. שם המשאב הזה מזהה את הקהל שמופיע ברשימה ומשותף בין ממשקי Analytics Data ו-Admin APIs. פורמט: |
audienceDisplayName |
פלט בלבד. השם התיאורי לתצוגה של הקהל הזה. לדוגמה, "רוכשים". |
dimensions[] |
חובה. המאפיינים המבוקשים ומוצגים בתגובת השאילתה. |
creationQuotaTokensCharged |
פלט בלבד. סך אסימוני המכסה שחויבו במהלך היצירה של AudienceExport. מכיוון שמספר האסימונים הזה מבוסס על פעילות במצב |
state |
פלט בלבד. המצב הנוכחי של ייצוא הקהל הזה. |
beginCreatingTime |
פלט בלבד. השעה שבה בוצעה קריאה ל-AudienceExports.create והפעולה של AudienceExport התחילה למצב חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
rowCount |
פלט בלבד. המספר הכולל של השורות בתוצאה של AudienceExport. |
errorMessage |
פלט בלבד. הודעת השגיאה מאוכלסת כשייצוא קהל נכשל במהלך היצירה. אחת הסיבות הנפוצות לכשל היא מיצוי המכסה. |
percentageCompleted |
פלט בלבד. האחוז שהושלם עבור ייצוא קהל זה נע בין 0 ל-100. |
AudienceDimension
מאפיין קהל הוא מאפיין של משתמש. יש בקשה לשייך משתמש ספציפי, ולאחר מכן להחזיר אותה בQueryAudienceExportResponse
.
ייצוג JSON |
---|
{ "dimensionName": string } |
שדות | |
---|---|
dimensionName |
זה שינוי אופציונלי. שם ה-API של המאפיין. רשימה של שמות המאפיינים מופיעה בקטע מאפייני API. |
ארץ
ייצוא הקהלים קיים כרגע במצב הזה.
טיפוסים בני מנייה (enums) | |
---|---|
STATE_UNSPECIFIED |
אף פעם לא ייעשה שימוש במצב שלא צוין. |
CREATING |
המערכת יוצרת כרגע את התכונה Audience Export ותהיה זמינה בעתיד. היצירה מתרחשת מיד אחרי הקריאה AudienceExports.create. |
ACTIVE |
הכלי AudienceExport נוצר במלואו ומוכן לשליחת שאילתות. מתבצע עדכון של AudienceExport כך שיהיה פעיל מבקשה באופן אסינכרוני. הפעולה הזו מתרחשת זמן מה (למשל 15 דקות) אחרי שיחת היצירה הראשונית. |
FAILED |
היצירה של AudienceExport נכשלה. ייתכן שבקשה מחדש של ייצוא הקהלים הזה תצליח. |
שיטות |
|
---|---|
|
יצירת ייצוא של קהלים לאחזור מאוחר יותר. |
|
קבלת מטא-נתונים של ההגדרות של ייצוא קהל ספציפי. |
|
בתיבת הדו-שיח הזו מפורטים כל פעולות הייצוא של קהלים בנכס מסוים. |
|
אחזור של ייצוא קהלים של משתמשים. |