AssetGroup

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

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "primaryStatus": enum (AssetGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AssetGroupPrimaryStatusReason)
  ],
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
שדות
resourceName

string

בלתי משתנה. שם המשאב של קבוצת הנכסים. דוגמאות לשמות משאבים בקבוצות נכסים:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

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

campaign

string

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

name

string

חובה. השם של קבוצת הנכסים. חובה. האורך המינימלי צריך להיות 1 והאורך המקסימלי הוא 128. המזהה לצורכי קמפיין חייב להיות ייחודי.

finalUrls[]

string

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

finalMobileUrls[]

string

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

status

enum (AssetGroupStatus)

הסטטוס של קבוצת הנכסים.

primaryStatus

enum (AssetGroupPrimaryStatus)

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

primaryStatusReasons[]

enum (AssetGroupPrimaryStatusReason)

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

path1

string

החלק הראשון של הטקסט שעשוי להיות מצורף לכתובת ה-URL שמוצגת במודעה.

path2

string

החלק השני של הטקסט שעשוי להופיע כמצורף לכתובת ה-URL המוצגת במודעה. אפשר להגדיר את השדה הזה רק כשמוגדר נתיב 1.

adStrength

enum (AdStrength)

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

AssetGroupStatus

הסטטוסים האפשריים של קבוצת נכסים.

טיפוסים בני מנייה (enums)
UNSPECIFIED הסטטוס לא צוין.
UNKNOWN הערך שהתקבל לא ידוע בגרסה הזו.
ENABLED קבוצת הנכסים מופעלת.
PAUSED קבוצת הנכסים מושהית.
REMOVED קבוצת הנכסים הוסרה.

AssetGroupPrimaryStatus

מספרי טיפוסים בני מנייה (enum) שמתאר את הסטטוס הראשי האפשרי של קבוצת הנכסים. מספק תובנות לגבי הסיבה לכך שקבוצת נכסים לא מוצגת או לא מוצגת באופן אופטימלי.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
ELIGIBLE קבוצת הנכסים כשירה להצגה.
PAUSED קבוצת הנכסים מושהית.
REMOVED קבוצת הנכסים הוסרה.
NOT_ELIGIBLE קבוצת הנכסים לא כשירה להצגת מודעות.
LIMITED ההצגה של קבוצת הנכסים מוגבלת.
PENDING קבוצת הנכסים ממתינה לאישור ויכול להיות שהיא תוצג בעתיד.

AssetGroupPrimaryStatusReason

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
ASSET_GROUP_PAUSED הסטטוס של קבוצת הנכסים שציין המשתמש מושהה.
ASSET_GROUP_REMOVED המערכת מסירה את הסטטוס של קבוצת הנכסים שצוינה על ידי המשתמש.
CAMPAIGN_REMOVED סטטוס הקמפיין שצוין על ידי המשתמש הוסר.
CAMPAIGN_PAUSED סטטוס הקמפיין שצוין על ידי המשתמש מושהה.
CAMPAIGN_PENDING הזמן שצוין על ידי המשתמש להתחלה של הקמפיין חל בעתיד.
CAMPAIGN_ENDED הזמן שצוין על ידי המשתמש לסיום הקמפיין הזה חלף.
ASSET_GROUP_LIMITED קבוצת הנכסים אושרה, אבל מוצגת בה רק קיבולת מוגבלת בהתאם למדיניות.
ASSET_GROUP_DISAPPROVED קבוצת הנכסים סומנה כ'נדחתה'.
ASSET_GROUP_UNDER_REVIEW בדיקת התאימות למדיניות של קבוצת הנכסים לא הסתיימה.