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)

غير قابل للتغيير رقم تعريف مجموعة مواد العرض الرئيسية لمجموعة مواد العرض التي تأتي منها عناصر مجموعة مواد العرض هذه. على سبيل المثال، معرّف مجموعة مواد عرض المواقع الجغرافية على مستوى المزامنة التي تأتي منها العناصر في مجموعة مواد عرض مجموعات المواقع الجغرافية. هذا الحقل مطلوب ولا ينطبق إلا على مجموعة مواد العرض من النوع "مجموعة مواقع جغرافية".
hotelPropertyData

object (HotelPropertyData)

النتائج فقط. بالنسبة إلى "حملات الأداء الأفضل" المستندة إلى أهداف السفر التي تتضمّن رابطًا لحساب Hotel Center: للقراءة فقط.
حقل الربط asset_set_source بيانات مجموعة مواد العرض الخاصة بكل نوع من أنواع مجموعات مواد العرض لا تحتوي بعض الأنواع على بيانات محدّدة. يمكن أن يكون asset_set_source واحدًا فقط مما يلي:
locationSet

object (LocationSet)

بيانات مجموعة مواد عرض المواقع الجغرافية سيتم استخدام هذا الإعداد لضبط الموقع الجغرافي على مستوى المزامنة. لا يمكن ضبط هذا الإعداد إلا إذا كان نوع AssetSet هو LOCATION_SYNC.
businessProfileLocationGroup

object (BusinessProfileLocationGroup)

بيانات مجموعة مواد عرض المواقع الجغرافية في "الملف التجاري على Google"
chainLocationGroup

object (ChainLocationGroup)

تمثّل معلومات عن مجموعة مواقع جغرافية ديناميكية للسلاسل. لا ينطبق ذلك إلا إذا كان نوع مجموعة مواد العرض على مستوى المزامنة هو LOCATION_SYNC وكان مصدر المزامنة هو chain.

AssetSetStatus

الحالات المحتملة لمجموعة مواد عرض

عمليات التعداد
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" يتم ربط أنواع الفلاتر المختلفة باستخدام "و"، في حال تحديدها.

تمثيل 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

الأنواع المحتملة للعلاقة

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
AUTO_DEALERS العلاقة بوكيل بيع السيارات
GENERAL_RETAILERS العلاقة العامة ببائع التجزئة

ChainFilter

فلتر واحد على مستوى السلسلة حسب الموقع الجغرافي في مجموعة عناصر الخلاصة عامل التشغيل المنطقي للفلترة بين جميع الحقول هو "و".

تمثيل JSON 
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
الحقول
chainId

string (int64 format)

مطلوب. تُستخدَم لفلترة المواقع الجغرافية للسلاسل حسب معرّف السلسلة. ولن تتضمّن مجموعة مواد العرض سوى المواقع الجغرافية للسلسلة التي تنتمي إلى السلسلة المحدّدة.
locationAttributes[]

string

تُستخدَم لفلترة المواقع الجغرافية للسلسلة حسب سمات المواقع الجغرافية. ولن تتضمّن مجموعة مواد العرض سوى المواقع الجغرافية للسلاسل التي تنتمي إلى جميع السمات المحدّدة. إذا كان هذا الحقل فارغًا، يعني ذلك عدم إجراء فلترة على هذا الحقل.

MapsLocationSet

حزمة لبيانات مزامنة المواقع الجغرافية في خرائط متعدّدة

تمثيل JSON 
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
الحقول
mapsLocations[]

object (MapsLocationInfo)

مطلوب. قائمة بمعلومات المواقع الجغرافية في الخرائط التي تمت مزامنتها يدويًا من قِبل المستخدم

MapsLocationInfo

عنصر تغليف لأرقام تعريف الأماكن

تمثيل JSON 
{
  "placeId": string
}
الحقول
placeId

string

معرّف المكان للموقع الجغرافي على "خرائط Google"

BusinessProfileLocationGroup

معلومات عن مجموعة مواقع جغرافية ديناميكية في "الملف التجاري على Google" لا ينطبق ذلك إلا إذا كان نوع AssetSet على مستوى المزامنة هو LOCATION_SYNC وكان مصدر المزامنة هو "الملف التجاري".

تمثيل JSON 
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
الحقول
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

فلترة مجموعات المواقع الجغرافية الديناميكية في "الملف التجاري"

DynamicBusinessProfileLocationGroupFilter

تمثّل فلترًا على المواقع الجغرافية للملف التجاري في مجموعة مواد عرض. في حال تقديم فلاتر متعددة، يتم ربطها باستخدام "و".

تمثيل JSON 
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
الحقول
labelFilters[]

string

تُستخدَم لفلترة المواقع الجغرافية للملف التجاري حسب التصنيف. ولن تتضمّن مجموعة مواد العرض سوى المواقع الجغرافية التي تتضمّن أيًا من التصنيفات المدرَجة. يتم ربط فلاتر التصنيفات باستخدام "أو".
listingIdFilters[]

string (int64 format)

تُستخدَم لفلترة مواقع "الملف التجاري على Google" حسب أرقام تعريف البيانات.
businessNameFilter

object (BusinessProfileBusinessNameFilter)

تُستخدَم لفلترة المواقع الجغرافية في "الملف التجاري على Google" حسب اسم النشاط التجاري.

BusinessProfileBusinessNameFilter

فلتر أسماء الأنشطة التجارية في مجموعة المواقع الجغرافية للملف التجاري

تمثيل JSON 
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
الحقول
businessName

string

سلسلة اسم النشاط التجاري المطلوب استخدامها للفلترة
filterType

enum (LocationStringFilterType)

نوع مطابقة السلسلة المطلوب استخدامه عند الفلترة باستخدام businessName

LocationStringFilterType

الأنواع المحتملة لفلترة سلسلة المواقع الجغرافية

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
EXACT سيستخدم الفلتر مطابقة السلسلة التامة.

ChainLocationGroup

تمثّل معلومات عن مجموعة مواقع جغرافية ديناميكية للسلاسل. لا ينطبق ذلك إلا إذا كان نوع مجموعة مواد العرض على مستوى المزامنة هو LOCATION_SYNC وكان مصدر المزامنة هو chain.

تمثيل JSON 
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
الحقول
dynamicChainLocationGroupFilters[]

object (ChainFilter)

تُستخدَم لفلترة المواقع الجغرافية للسلاسل حسب أرقام تعريف السلاسل. ولن تتضمّن مجموعة مواد العرض سوى المواقع الجغرافية التي تنتمي إلى السلاسل المحدّدة.