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)

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

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)

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