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

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

string

تُستخدَم هذه الوظيفة لفلترة بيانات "الملف التجاري" حسب التصنيفات. في حال توفُّر إدخالات في فلاتر التصنيفات، ستكون بطاقات البيانات التي تتضمّن مجموعة التصنيفات فقط هي المرشحة لتتم مزامنتها في 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 علاقة عامة ببائع تجزئة.