AssetSet

קבוצת נכסים שמייצגת אוסף של נכסים. משתמשים ב-AssetSetAsset כדי לקשר נכס לקבוצת הנכסים.

ייצוג ב-JSON 
{
  "id": string,
  "resourceName": string,
  "name": string,
  "type": enum (AssetSetType),
  "status": enum (AssetSetStatus),
  "merchantCenterFeed": {
    object (MerchantCenterFeed)
  },
  "locationGroupParentAssetSetId": string,
  "hotelPropertyData": {
    object (HotelPropertyData)
  },

  // Union field asset_set_source can be only one of the following:
  "locationSet": {
    object (LocationSet)
  },
  "businessProfileLocationGroup": {
    object (BusinessProfileLocationGroup)
  },
  "chainLocationGroup": {
    object (ChainLocationGroup)
  }
  // End of list of possible types for union field asset_set_source.
}
שדות
id

string (int64 format)

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

string

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

customers/{customerId}/assetSets/{asset_set_id}
name

string

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

enum (AssetSetType)

חובה. לא ניתן לשינוי. הסוג של קבוצת הנכסים. חובה.
status

enum (AssetSetStatus)

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

object (MerchantCenterFeed)

מספר חשבון המוכר ותווית הפיד מ-Google Merchant Center.
locationGroupParentAssetSetId

string (int64 format)

לא ניתן לשינוי. מזהה קבוצת הנכסים ההורה של קבוצת הנכסים שממנה מגיעים הרכיבים של קבוצת הנכסים הזו. לדוגמה: מזהה AssetSet של מיקום ברמת הסנכרון שממנו מגיעים הרכיבים ב-AssetSet של קבוצת המיקומים. השדה הזה חובה ורלוונטי רק לקבוצת נכסים מסוג 'קבוצת מיקומים'.
hotelPropertyData

object (HotelPropertyData)

פלט בלבד. בקמפיינים למיקסום הביצועים לענף התיירות והאירוח עם קישור לחשבון Hotel Center. קריאה בלבד.
שדה האיחוד asset_set_source. נתונים של קבוצת נכסים שספציפיים לכל סוג של קבוצת נכסים. לא לכל הסוגים יש נתונים ספציפיים. הערך של asset_set_source יכול להיות רק אחת מהאפשרויות הבאות:
locationSet

object (LocationSet)

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

object (BusinessProfileLocationGroup)

נתוני קבוצת הנכסים של קבוצת המיקומים בפרופיל העסק.
chainLocationGroup

object (ChainLocationGroup)

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

AssetSetStatus

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

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

MerchantCenterFeed

מספר חשבון המוכר ותווית הפיד מ-Google Merchant Center.

ייצוג ב-JSON 
{
  "merchantId": string,
  "feedLabel": string
}
שדות
merchantId

string (int64 format)

חובה. מספר חשבון המוכר מ-Google Merchant Center
feedLabel

string

זה שינוי אופציונלי. תווית פיד מ-Google Merchant Center.

HotelPropertyData

בקמפיינים למיקסום הביצועים לענף התיירות והאירוח עם קישור לחשבון Hotel Center. קריאה בלבד.

ייצוג ב-JSON 
{
  "hotelCenterId": string,
  "partnerName": string
}
שדות
hotelCenterId

string (int64 format)

פלט בלבד. מספר החשבון של השותף ב-Hotel Center.
partnerName

string

פלט בלבד. השם של שותף המלון.

LocationSet

נתונים שקשורים לקבוצת המיקומים. צריך לציין אחד מהנתונים הבאים: נתונים מפרופיל העסק ב-Google (לשעבר 'Google לעסק שלי'), נתונים של רשתות ונתוני מיקום במפה.

ייצוג ב-JSON 
{
  "locationOwnershipType": enum (LocationOwnershipType),

  // Union field source can be only one of the following:
  "businessProfileLocationSet": {
    object (BusinessProfileLocationSet)
  },
  "chainLocationSet": {
    object (ChainSet)
  },
  "mapsLocationSet": {
    object (MapsLocationSet)
  }
  // End of list of possible types for union field source.
}
שדות
locationOwnershipType

enum (LocationOwnershipType)

חובה. לא ניתן לשינוי. סוג הבעלות על המיקום (מיקום בבעלות או מיקום לחיפוש מפיצים).
שדה האיחוד source. נתוני מיקום ספציפיים לכל מקור סנכרון. הערך של source יכול להיות רק אחת מהאפשרויות הבאות:
businessProfileLocationSet

object (BusinessProfileLocationSet)

נתונים המשמשים להגדרת קבוצת מיקומים שמאוכלסת ממיקומים בפרופיל העסק ב-Google.
chainLocationSet

object (ChainSet)

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

object (MapsLocationSet)

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

BusinessProfileLocationSet

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

ייצוג ב-JSON 
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
שדות
httpAuthorizationToken

string

חובה. לא ניתן לשינוי. טוקן ההרשאה של HTTP שמשמש לקבלת הרשאה.
emailAddress

string

חובה. לא ניתן לשינוי. כתובת האימייל של חשבון 'פרופיל העסק ב-Google' או כתובת האימייל של מנהל בחשבון 'פרופיל העסק ב-Google'.
businessNameFilter

string

משמש לסינון כרטיסי מוצר של 'פרופיל העסק ב-Google' לפי שם העסק. אם האפשרות businessNameFilter מוגדרת, רק כרטיסי מוצר עם שם עסק תואם יוכלו להסתנכרן עם 'נכסים'.
labelFilters[]

string

משמש לסינון דפים עסקיים ב'פרופיל העסק ב-Google' לפי תוויות. אם יש רשומות ב-labelFilters, רק כרטיסי מוצר שהוגדרו להם תוויות כלשהן יוכלו לעבור סנכרון עם 'נכסים'. אם אין רשומות ב-labelFilters, כל כרטיסי המוצר מתאימים לסנכרון. מסנני התוויות משולבים באמצעות OR.
listingIdFilters[]

string (int64 format)

משמש לסינון כרטיסי מוצר ב'פרופיל העסק ב-Google' לפי מזהה כרטיס המוצר. אם יש רשומות ב-listingIdFilters, רק כרטיסי מוצר שצוינו במסננים יהיו מועמדים לסנכרון עם 'נכסים'. אם אין רשומות ב-listingIdFilters, כל כרטיסי המוצר עומדים בקריטריונים לסנכרון. מסנני מזהי כרטיסי המוצר מקושרים באמצעות OR.
businessAccountId

string

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

ChainSet

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

ייצוג ב-JSON 
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
שדות
relationshipType

enum (ChainRelationshipType)

חובה. לא ניתן לשינוי. סוג הקשר של הרשתות שצוינו עם המפרסם הזה.
chains[]

object (ChainFilter)

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

ChainRelationshipType

סוגי הקשר האפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
AUTO_DEALERS קשר עם סוכנות רכב.
GENERAL_RETAILERS קשר עם חנות כלבו.

ChainFilter

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

ייצוג ב-JSON 
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
שדות
chainId

string (int64 format)

חובה. משמש לסינון מיקומי רשתות לפי מזהה הרשת. רק מיקומי רשתות ששייכים לרשת שצוינה ייכללו בקבוצת הנכסים.
locationAttributes[]

string

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

MapsLocationSet

Wrapper לנתוני סנכרון של מיקומים במספר מפות

ייצוג ב-JSON 
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
שדות
mapsLocations[]

object (MapsLocationInfo)

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

MapsLocationInfo

wrapper למזהי מקומות

ייצוג ב-JSON 
{
  "placeId": string
}
שדות
placeId

string

מזהה המקום של המיקום במפות Google.

BusinessProfileLocationGroup

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

ייצוג ב-JSON 
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
שדות
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

סינון לפי קבוצות של מיקומים דינמיים בפרופיל העסק.

DynamicBusinessProfileLocationGroupFilter

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

ייצוג ב-JSON 
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
שדות
labelFilters[]

string

משמש לסינון המיקומים של פרופיל העסק לפי תווית. רק מיקומים עם אחת מהתוויות המפורטות ייכללו בקבוצת הנכסים. מסנני התוויות משולבים באמצעות OR.
listingIdFilters[]

string (int64 format)

משמש לסינון המיקומים של פרופיל העסק לפי מזהי כרטיסי מוצר.
businessNameFilter

object (BusinessProfileBusinessNameFilter)

משמש לסינון המיקומים בפרופיל העסק לפי שם העסק.

BusinessProfileBusinessNameFilter

מסנן שם העסק של קבוצת מיקומים בפרופיל העסק ב-Google.

ייצוג ב-JSON 
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
שדות
businessName

string

מחרוזת של שם העסק לשימוש בסינון.
filterType

enum (LocationStringFilterType)

סוג ההתאמה למחרוזת שישמש לסינון באמצעות businessName.

LocationStringFilterType

סוגי מסננים אפשריים של מחרוזת מיקום.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EXACT המסנן ישתמש בהתאמה מדויקת למחרוזות.

ChainLocationGroup

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

ייצוג ב-JSON 
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
שדות
dynamicChainLocationGroupFilters[]

object (ChainFilter)

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