AssetGroupListingGroupFilter

يمثّل AssetGroupListingGroupFilter عقدة شجرة بيانات لمجموعة البيانات في مجموعة مواد عرض.

تمثيل JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "listingSource": enum (ListingGroupFilterListingSource),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
الحقول
resourceName

string

غير قابل للتغيير. اسم المصدر لفلتر مجموعة بيانات مجموعة مواد العرض يكون اسم مورد فلتر مجموعة بيانات مجموعة مواد العرض على النحو التالي:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

غير قابل للتغيير. مجموعة مواد العرض التي يشكّل فلتر مجموعة بيانات مجموعة مواد العرض هذا جزءًا منها.
id

string (int64 format)

النتائج فقط. رقم تعريف ListingGroupFilter.
type

enum (ListingGroupFilterType)

غير قابل للتغيير. نوع عقدة فلتر مجموعة البيانات.
listingSource

enum (ListingGroupFilterListingSource)

غير قابل للتغيير. مصدر البيانات التي تمت فلترتها من خلال فلتر مجموعة البيانات هذا.
caseValue

object (ListingGroupFilterDimension)

قيمة السمة التي تعمل بها مجموعة البيانات هذه على تحسين عنصرها الرئيسي. غير معرَّف للمجموعة الجذر.
parentListingGroupFilter

string

غير قابل للتغيير. اسم المورد للقسم الفرعي لمجموعة البيانات الرئيسية. قيمة فارغة لعقدة فلتر مجموعة بيانات الجذر.
path

object (ListingGroupFilterDimensionPath)

النتائج فقط. مسار السمات التي تحدِّد فلتر مجموعة البيانات هذا.

ListingGroupFilterType

نوع فلتر مجموعة البيانات.

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

ListingGroupFilterListingSource

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
SHOPPING البيانات من مصدر Shopping، مثل منتجات من Google Merchant Center
WEBPAGE البيانات من مصدر صفحة ويب، مثل عناوين URL من خلاصة صفحة أو من نطاق الويب للمعلِن

ListingGroupFilterDimension

سمات البيانات لفلتر مجموعة بيانات مجموعة مواد العرض

تمثيل JSON 
{

  // Union field dimension can be only one of the following:
  "productCategory": {
    object (ProductCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  },
  "webpage": {
    object (Webpage)
  }
  // End of list of possible types for union field dimension.
}
الحقول
حقل الاتحاد dimension ويكون أحد السمات الواردة أدناه موجودًا دائمًا. يمكن أن يكون الحقل "dimension" واحدًا فقط مما يلي:
productCategory

object (ProductCategory)

فئة العرض الترويجي للمنتج.
productBrand

object (ProductBrand)

العلامة التجارية لعرض المنتج.
productChannel

object (ProductChannel)

المنطقة المحلية لعرض المنتج.
productCondition

object (ProductCondition)

حالة عرض المنتج.
productCustomAttribute

object (ProductCustomAttribute)

السمة المخصّصة لعرض منتج.
productItemId

object (ProductItemId)

معرّف السلعة لعرض منتج معيّن.
productType

object (ProductType)

نوع العرض الترويجي للمنتج.
webpage

object (Webpage)

فلاتر عناوين URL في خلاصة الصفحة وعناوين URL من نطاق الويب للمعلِن

ProductCategory

عنصر واحد من فئة على مستوى معين. وفئات المستوى الأعلى تكون في المستوى 1، وأطفالهم في المستوى 2، وهكذا. نتيح حاليًا استخدام ما يصل إلى 5 مستويات. يجب أن يحدّد المستخدِم نوع سمة يشير إلى مستوى الفئة. يجب أن يكون لكل حالات التقسيم الفرعي نفسه نوع السمة نفسه (مستوى الفئة).

تمثيل JSON 
{
  "level": enum (ListingGroupFilterProductCategoryLevel),
  "categoryId": string
}
الحقول
level

enum (ListingGroupFilterProductCategoryLevel)

يشير إلى مستوى الفئة في التصنيف.
categoryId

string (int64 format)

رقم تعريف فئة المنتج.

يعادل هذا المعرّف رقم تعريف فئة_المنتجات google_product_category كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436

ListingGroupFilterProductCategoryLevel

مستوى فئة المنتج لفلتر مجموعة البيانات.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
LEVEL1 المستوى 1.
LEVEL2 المستوى 2.
LEVEL3 المستوى 3.
LEVEL4 المستوى 4.
LEVEL5 المستوى 5.

ProductBrand

العلامة التجارية للمنتج

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

string

قيمة السلسلة للعلامة التجارية للمنتج

ProductChannel

المنطقة المحلية لعرض المنتج.

تمثيل JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
الحقول
channel

enum (ListingGroupFilterProductChannel)

قيمة المنطقة المحلية

ListingGroupFilterProductChannel

يشير هذا المقياس إلى قيم التعداد التي تصف المنطقة المحلية لعرض منتج.

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

ProductCondition

حالة عرض المنتج.

تمثيل JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
الحقول
condition

enum (ListingGroupFilterProductCondition)

قيمة الشرط.

ListingGroupFilterProductCondition

يشير هذا المقياس إلى قيم التعداد التي تصف حالة عرض المنتج.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
NEW أن تكون حالة المنتج جديدة.
REFURBISHED حالة المنتج مجدَّد.
USED يتم استخدام حالة المنتج.

ProductCustomAttribute

السمة المخصّصة لعرض منتج.

تمثيل JSON 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
الحقول
index

enum (ListingGroupFilterCustomAttributeIndex)

يشير إلى فهرس السمة المخصّصة.
value

string

قيمة السلسلة للسمة المخصّصة للمنتج.

ListingGroupFilterCustomAttributeIndex

فهرس سمات العملاء.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
INDEX0 السمة المخصّصة لفلتر مجموعة البيانات الأولى.
INDEX1 السمة المخصّصة الثانية لفلتر مجموعة البيانات:
INDEX2 السمة المخصّصة لفلتر مجموعة البيانات الثالثة.
INDEX3 السمة المخصّصة لفلتر مجموعة البيانات الرابعة.
INDEX4 السمة المخصّصة لفلتر مجموعة البيانات الخامسة.

ProductItemId

معرّف السلعة لعرض منتج معيّن.

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

string

قيمة المعرّف

ProductType

نوع العرض الترويجي للمنتج.

تمثيل JSON 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
الحقول
level

enum (ListingGroupFilterProductTypeLevel)

تمثّل هذه السمة مستوى النوع.
value

string

قيمة النوع.

ListingGroupFilterProductTypeLevel

يشير هذا المقياس إلى قيم التعداد التي تصف مستوى نوع عرض المنتج.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
LEVEL1 المستوى 1.
LEVEL2 المستوى 2.
LEVEL3 المستوى 3.
LEVEL4 المستوى 4.
LEVEL5 المستوى 5.

صفحة ويب

فلاتر عناوين URL في خلاصة الصفحة وعناوين URL من نطاق الويب للمعلِن يُسمح بعدة عُقد جذرية بهذه السمة في مجموعة مواد عرض ويتم وضع شروطها في "أو".

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

object (WebpageCondition)

تجدر الإشارة إلى أنّ شروط صفحة الويب حسّاسة لحالة الأحرف، ويتمّ دمجها معًا عند تقييمها للفلترة. يجب أن تكون جميع الشروط من نفس النوع. مثال 1: بالنسبة إلى عنوان URL1 = www.ads.google.com?ocid=1&euid=2 و URL2 = www.ads.google.com?ocid=1 وحيث "ocid" و"euid" كـ "urlيحتوي على شروط"، ستتم مطابقة عنوان URL1، ولكن لن تتم مطابقة عنوان URL2.

المثال 2 : إذا كان عنوان URL1 يحتوي على "label1"، و"label2" و"عنوان URL2" يحتويان على "label2" و"label3"، فعند استخدام "label1" و"label2" كشروط تصنيف مخصّص، ستتم مطابقة عنوان URL 1 ولكن لن يكون عنوان URL2. وباستخدام التصنيف 2 بوصفه شرط تصنيف مخصّص الوحيد، ستتم مطابقة كل من عنوان URL 1 وعنوان URL 2.

WebpageCondition

شرط مطابق لفلترة عناوين URL

تمثيل JSON 
{

  // Union field condition can be only one of the following:
  "customLabel": string,
  "urlContains": string
  // End of list of possible types for union field condition.
}
الحقول
حقل الاتحاد condition شرط لفلترة عناوين URL. يمكن أن يكون condition واحدًا فقط مما يلي:
customLabel

string

يؤدي إلى فلترة عناوين URL في خلاصة صفحة تحتوي على هذا التصنيف المخصّص. يمكن إضافة تصنيف مخصّص إلى إحدى الحملات عن طريق إنشاء مجموعة مواد عرض من النوع PAGE_Feed وربطها بالحملة باستخدام CampaignAssetSet.
urlContains

string

يفلتر عناوين URL في خلاصة صفحة وعناوين URL من نطاق ويب المعلن الذي يحتوي على هذه السلسلة.

ListingGroupFilterDimensionPath

المسار الذي يحدِّد السمات التي تحدِّد فلتر مجموعة البيانات.

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

object (ListingGroupFilterDimension)

النتائج فقط. المسار الكامل للسمات من خلال العرض الهرمي لفلتر مجموعة البيانات (باستثناء العقدة الجذر) إلى فلتر مجموعة البيانات هذا.