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 للموقع الجغرافي على مستوى المزامنة الذي تأتي منه العناصر في LocationGroup AssetSet هذا الحقل مطلوب، ولا ينطبق إلا على مجموعة المواقع الجغرافية التي ونوعها AssetSet.
hotelPropertyData

object (HotelPropertyData)

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

object (LocationSet)

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

object (BusinessProfileLocationGroup)

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

object (ChainLocationGroup)

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

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)

النتائج فقط. رقم تعريف مركز إدارة معلومات الفنادق الخاص بالشريك
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

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

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

رقم تعريف المكان لموقع الخرائط.

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)

يتم استخدامه لفلترة المواقع الجغرافية في "الملف التجاري" حسب أرقام تعريف البيانات.
businessNameFilter

object (BusinessProfileBusinessNameFilter)

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

BusinessProfileBusinessNameFilter

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

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

string

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

enum (LocationStringFilterType)

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

LocationStringFilterType

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

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

ChainLocationGroup

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

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

object (ChainFilter)

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