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" يتم استخدام 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

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

عمليات التعداد
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

رقم تعريف مكان الموقع الجغرافي على "خرائط 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)

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

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)

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