Feed

خلاصة

تمثيل JSON 
{
  "resourceName": string,
  "attributes": [
    {
      object (FeedAttribute)
    }
  ],
  "attributeOperations": [
    {
      object (FeedAttributeOperation)
    }
  ],
  "origin": enum (FeedOrigin),
  "status": enum (FeedStatus),
  "id": string,
  "name": string,

  // Union field system_feed_generation_data can be only one of the following:
  "placesLocationFeedData": {
    object (PlacesLocationFeedData)
  },
  "affiliateLocationFeedData": {
    object (AffiliateLocationFeedData)
  }
  // End of list of possible types for union field system_feed_generation_data.
}
الحقول
resourceName

string

غير قابل للتغيير. اسم مورد الخلاصة تكون أسماء موارد الخلاصة على النحو التالي:

customers/{customerId}/feeds/{feedId}
attributes[]

object (FeedAttribute)

تمثّل هذه السمة سمات الخلاصة. تكون هذه السمة مطلوبة في CREATE، ما لم يتم تقديم system_feed_generation_data، في هذه الحالة ستعدّل "إعلانات Google" الخلاصة باستخدام السمات الصحيحة. غير مسموح به عند UPDATE. استخدِم عمليات السمة لإضافة سمات جديدة.
attributeOperations[]

object (FeedAttributeOperation)

قائمة العمليات التي تغيّر سمات الخلاصة. يمكن إضافة السمات فقط، وليس إزالتها.
origin

enum (FeedOrigin)

غير قابل للتغيير. تحدّد هذه السمة المسؤول عن إدارة FeedAttributes للخلاصة.
status

enum (FeedStatus)

النتائج فقط. حالة الخلاصة هذا الحقل للقراءة فقط.
id

string (int64 format)

النتائج فقط. رقم تعريف الخلاصة. هذا الحقل للقراءة فقط.
name

string

غير قابل للتغيير. اسم الخلاصة مطلوبة.
حقل الاتحاد system_feed_generation_data بيانات النظام للخلاصة تحدّد هذه البيانات معلومات لإنشاء العناصر في الخلاصة في الخلاصة التي ينشئها النظام. يمكن أن تكون السمة "system_feed_generation_data" واحدة فقط مما يلي:
placesLocationFeedData

object (PlacesLocationFeedData)

البيانات المستخدَمة لإعداد خلاصة مواقع جغرافية تتم تعبئتها من "الملف التجاري"
affiliateLocationFeedData

object (AffiliateLocationFeedData)

البيانات المستخدَمة لإعداد خلاصة مواقع المعلِنين الجغرافية التي تمت تعبئتها بالسلاسل المحدّدة.

FeedAttribute

تحدد FeedAttributes أنواع البيانات التي يُتوقع أن تتوفر في أي خلاصة. تحدد سمة FeedAttribute الفردية النوع المتوقع من FeedItemAttributes باستخدام سمة FeedAttributeId نفسها. ويمكن اختياريًا وضع علامة على سمة FeedAttribute باعتبارها جزءًا من مفتاح FeedItem الفريد.

تمثيل JSON 
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
الحقول
type

enum (FeedAttributeType)

نوع البيانات لسمة الخلاصة مطلوبة.
id

string (int64 format)

رقم تعريف السمة.
name

string

اسم السمة. مطلوبة.
isPartOfKey

boolean

يشير إلى أن البيانات المقابلة لهذه السمة هي جزء من مفتاح FeedItem الفريد. ويتم تعيينها تلقائيًا على "خطأ" إذا لم يتم تحديدها. ملاحظة: لا يُشترط استخدام مفتاح فريد في مخطط الخلاصة، وفي هذه الحالة يجب الإشارة إلى FeedItems من خلال feed_item_id.

FeedAttributeType

أنواع البيانات المحتملة لسمة خلاصة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
INT64 Int64.
DOUBLE مزدوجة
STRING سلسلة.
BOOLEAN منطقي.
URL عنوان URL
DATE_TIME التاريخ والوقت.
INT64_LIST قائمة Int64.
DOUBLE_LIST قائمة مزدوجة (8 بايت).
STRING_LIST قائمة سلاسل.
BOOLEAN_LIST قائمة منطقية.
URL_LIST قائمة عناوين URL.
DATE_TIME_LIST قائمة التواريخ والوقت.
PRICE السعر

FeedAttributeOperation

العملية التي سيتم تنفيذها على قائمة سمات خلاصة في عملية تغيير.

تمثيل JSON 
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
الحقول
operator

enum (Operator)

النتائج فقط. نوع عملية القائمة المطلوب تنفيذها.
value

object (FeedAttribute)

النتائج فقط. سمة الخلاصة التي تتم إضافتها إلى القائمة

المؤثِّر

عامل التشغيل.

عمليات التعداد
UNSPECIFIED غير محدد
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ADD أضِف السمة إلى السمات الحالية.

FeedOrigin

القيم المحتملة لأصل الخلاصة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
USER يُدير المستخدم سمات FeedAttributes لهذه الخلاصة. يمكن للمستخدمين إضافة FeedAttributes إلى هذه الخلاصة.
GOOGLE تنشئ Google سمات FeedAttributes لخلاصة GOOGLE. تحتفظ Google بخلاصة من هذا النوع وستتضمّن السمات الصحيحة لنوع العنصر النائب للخلاصة.

FeedStatus

الحالات المحتملة للخلاصة.

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

PlacesLocationFeedData

البيانات المستخدَمة لإعداد خلاصة مواقع جغرافية تتم تعبئتها من "الملف التجاري"

تمثيل JSON 
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
الحقول
oauthInfo

object (OAuthInfo)

غير قابل للتغيير. رمز المصادقة المطلوب (من واجهة برمجة تطبيقات OAuth) للبريد الإلكتروني. لا يمكن تحديد هذا الحقل إلا في طلب إنشاء. كل حقوله الفرعية غير قابلة للاختيار.
businessAccountId

string

رقم تعريف صفحة Plus للنشاط التجاري المُدار الذي يجب استخدام مواقعه الجغرافية. وفي حال عدم ضبط هذا الحقل، يتم استخدام جميع الأنشطة التجارية التي يمكن للمستخدم الوصول إليها (محدّدة من خلال عنوان البريد الإلكتروني). هذا الحقل قابل للتغيير فقط ولا يمكن اختياره.
categoryFilters[]

string

تُستخدَم لفلترة بيانات "الملف التجاري" حسب الفئات. إذا كانت هناك إدخالات في categoryFilters، ستكون بطاقات البيانات التي تنتمي إلى أي من الفئات فقط هي المرشّحة لمزامنتها مع FeedItems. في حال عدم وجود أي إدخالات في فئة "عوامل تصفية الفئة"، تكون جميع بطاقات البيانات مناسبة للمزامنة.
labelFilters[]

string

تُستخدَم لفلترة بيانات "الملف التجاري" حسب التصنيفات. في حال توفُّر إدخالات في labelFilters، لن تتم مزامنتها في FeedItems إلا بطاقات بيانات المتجر التي تحتوي على أي من التصنيفات المحدَّدة. في حال عدم توفُّر أي إدخالات في labelFilters، ستكون جميع بطاقات البيانات صالحة لمزامنتها.
emailAddress

string

عنوان البريد الإلكتروني للملف التجاري أو عنوان البريد الإلكتروني لمدير الملف التجاري. مطلوبة.
businessNameFilter

string

تُستخدَم لفلترة بيانات "الملف التجاري" حسب اسم النشاط التجاري. في حال ضبط businessNameFilter، تكون البيانات التي تحمل اسم نشاط تجاري متطابقًا فقط هي المؤهَّلة للمزامنة مع FeedItems.

OAuthInfo

البيانات المستخدمة للتفويض باستخدام OAuth.

تمثيل JSON 
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
الحقول
httpMethod

string

طريقة HTTP المستخدمة للحصول على التفويض.
httpRequestUrl

string

عنوان URL لطلب HTTP المستخدَم للحصول على التفويض.
httpAuthorizationHeader

string

عنوان تفويض HTTP المستخدَم للحصول على التفويض.

AffiliateLocationFeedData

البيانات المستخدَمة لإعداد خلاصة مواقع المعلِنين الجغرافية التي تمت تعبئتها بالسلاسل المحدّدة.

تمثيل JSON 
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
الحقول
chainIds[]

string (int64 format)

قائمة السلاسل التي ستزامن منها خلاصة مواقع المعلِنين الجغرافية.
relationshipType

enum (AffiliateLocationFeedRelationshipType)

العلاقة التي تربطها السلاسل بالمعلن.

AffiliateLocationFeedRelationshipType

القيم المحتملة لنوع علاقة لخلاصة مواقع المعلِنين الجغرافية.

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