REST Resource: properties.recurringAudienceLists

משאב: RecurringAudienceList

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

ייצוג JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
שדות
name

string

פלט בלבד. מזהה. שם המשאב של רשימת הקהלים החוזרת שהוקצה במהלך היצירה. שם המשאב מזהה את RecurringAudienceList.

פורמט: properties/{property}/recurringAudienceLists/{recurringAudienceList}
audience

string

חובה. השם של משאב הקהל. שם המשאב הזה מזהה את הקהל שמופיע ברשימה ומשותף בין ממשקי Analytics Data ו-Admin APIs.

פורמט: properties/{property}/audiences/{audience}
audienceDisplayName

string

פלט בלבד. השם התיאורי לתצוגה של הקהל הזה. לדוגמה, "רוכשים".
dimensions[]

object (AudienceDimension)

חובה. המאפיינים המבוקשים והמוצגים בתגובה של רשימת החברים בקהל.
audienceLists[]

string

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

הרשימה הזו מסודרת לפי הרשימה האחרונה של חברים בקהל.
activeDaysRemaining

integer

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

בקשות חוזרות לרשימת חברים בקהל בנכסי Analytics 360 מוגדרות כברירת מחדל ל-180 ימים, לכל היותר 365 ימים. כברירת מחדל, בקשות לנכסים רגילים של Analytics הן 14 ימים, ואפשר להגדיר להן עד 30 יום.

הערך המינימלי שמותר במהלך היצירה הוא 1. בקשות שגבוהות מהמספר המקסימלי שלהן ייאכפו לערך המקסימלי.
webhookNotification

object (WebhookNotification)

זה שינוי אופציונלי. הגדרת התראות של תגובה לפעולה מאתר אחר (webhook) שיישלחו מ-Google Analytics Data API לשרת ה-webhook. השימוש ב-webhooks הוא אופציונלי. אם היא לא בשימוש, תצטרכו לבצע דגימה ב-API הזה כדי לקבוע מתי רשימת קהלים חוזרת יוצרת רשימות קהלים חדשות. תגובות לפעולה מאתר אחר (webhook) מאפשרות לשלוח התראות לשרתים וכך מונעים את הצורך לבצע סקרים.

שתי בקשות POST יישלחו בכל פעם שרשימת קהל חוזרת יוצרת רשימת חברים בקהל. התהליך הזה מתרחש פעם ביום, עד שנותרו 0 ימים פעילים של רשימת החברים בקהל. הבקשה הראשונה תישלח ותציג רשימה חדשה של החברים בקהל שנוצרה במצב 'יצירה'. הבקשה השנייה תישלח לאחר שרשימת החברים בקהל תושלם (במצב 'פעיל' או 'נכשל').

שיטות

create

 יוצרת רשימה חוזרת של חברים בקהל.

get

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

list

 בתיבת הדו-שיח הזו מפורטים כל רשימות הקהלים החוזרות של הנכס.