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 (فئة_المنتجات_من_google) كما هو موضّح في هذه المقالة: 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

يشير حقل Enum إلى حالة عرض منتج.

عمليات التعداد
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 من نطاق الويب للمعلِن يُسمَح في مجموعة مواد عرض بعدة عُقد جذرية تتضمّن هذه السمة ويتم مراعاة شروطها في عامل التشغيل OR.

تمثيل 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 يحتوي على تصنيف1 وتصنيف 2 وعنوان URL 2 يتضمن تصنيفًا 2 وتصنيفًا 3، وعند استخدام التصنيف 1 وتصنيف 2 كشروط تصنيف مخصّص، ستتم مطابقة عنوان URL 1 ولكن ليس عنوان URL 2. عند استخدام "التصنيف 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)

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