Method: properties.audienceLists.create

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

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

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

קהלים ב-Google Analytics 4 מאפשרים לפלח את המשתמשים בדרכים בעלות משמעות לעסק. מידע נוסף זמין בכתובת https://support.google.com/analytics/answer/9267572. רשימות הקהלים כוללות את המשתמשים בכל קהל.

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

בקשת HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
parent

string

חובה. משאב ההורה שבו תיווצר רשימת החברים בקהל. פורמט: properties/{property}

גוף הבקשה

גוף הבקשה מכיל מופע של AudienceList.

גוף התשובה

אם הפעולה בוצעה בהצלחה, גוף התגובה מכיל מופע חדש של Operation שנוצר.

היקפי הרשאות

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

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