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)

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

string (int64 format)

לא משתנה. מזהה קבוצת נכסים ברמה העליונה של קבוצת הנכסים שממנה מגיעים הרכיבים של קבוצת הנכסים הזו. לדוגמה: מזהה המיקום AssetSet ברמת הסנכרון, שממנו מגיעים הרכיבים ב-LocationGroup 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 ומקור הסנכרון הוא שרשרת.

AssetSetStatus

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

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

MerchantCenterFeed

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

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

string (int64 format)

חובה. מספר חשבון Merchant מ-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, אז כל הרישומים יהיו מועמדים לסנכרון. מסנני תוויות אוחדו יחד.
listingIdFilters[]

string (int64 format)

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

string

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

ChainSet

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

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

enum (ChainRelationshipType)

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

object (ChainFilter)

חובה. רשימה של מסננים ברמת הרשת. כל המסננים מחוברים יחד.

ChainRelationshipType

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

טיפוסים בני מנייה (enums)
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)

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

DynamicBusinessProfileLocationGroupFilter

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

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

string

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

string (int64 format)

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

object (BusinessProfileBusinessNameFilter)

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

BusinessProfileBusinessNameFilter

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

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

string

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

enum (LocationStringFilterType)

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

LocationStringFilterType

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

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

ChainLocationGroup

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

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

object (ChainFilter)

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