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 Ads فید را با ویژگی های صحیح به روز می کند. در UPDATE غیرمجاز است. از ویژگیOperations برای افزودن ویژگی های جدید استفاده کنید.

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 واحد نوع مورد انتظار FeedItemAttribute را با همان 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 است. اگر نامشخص باشد به صورت پیش فرض false می شود. توجه داشته باشید که یک کلید منحصر به فرد در طرح فید مورد نیاز نیست، در این صورت FeedItems باید توسط feed_item_id خود ارجاع داده شوند.

FeedAttributeType

انواع داده های ممکن برای یک ویژگی فید.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
INT64 Int64.
DOUBLE دو برابر.
STRING رشته
BOOLEAN بولی.
URL آدرس اینترنتی
DATE_TIME زمان قرار.
INT64_LIST لیست Int64.
DOUBLE_LIST لیست دوبل (8 بایت).
STRING_LIST لیست رشته ها
BOOLEAN_LIST لیست بولی.
URL_LIST فهرست آدرس.
DATE_TIME_LIST لیست تاریخ.
PRICE قیمت.

FeedAttributeOperation

عملیاتی که باید در لیست ویژگی های خوراک در یک جهش انجام شود.

نمایندگی JSON
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
زمینه های
operator

enum ( Operator )

فقط خروجی نوع عملیات لیست برای انجام.

value

object ( FeedAttribute )

فقط خروجی ویژگی فید به لیست اضافه می شود.

اپراتور

اپراتور.

Enums
UNSPECIFIED نامشخص
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ADD ویژگی را به ویژگی های موجود اضافه کنید.

FeedOrigin

مقادیر ممکن برای منبع خوراک.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
USER FeedAttributes برای این فید توسط کاربر مدیریت می شود. کاربران می توانند FeedAttributes را به این فید اضافه کنند.
GOOGLE FeedAttributes برای فید GOOGLE توسط Google ایجاد شده است. فید از این نوع توسط Google نگهداری می شود و دارای ویژگی های صحیح برای نوع مکان نگهدار فید است.

وضعیت فید

وضعیت های احتمالی یک فید

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ENABLED فید فعال است.
REMOVED فید حذف شده است.

PlacesLocationFeedData

داده‌های مورد استفاده برای پیکربندی فید مکان پر شده از نمایه کسب‌وکار.

نمایندگی JSON
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
زمینه های
oauthInfo

object ( OAuthInfo )

تغییرناپذیر. رمز احراز هویت مورد نیاز (از OAuth API) برای ایمیل. این فیلد را فقط می توان در یک درخواست ایجاد مشخص کرد. همه زیرفیلدهای آن قابل انتخاب نیستند.

businessAccountId

string

شناسه صفحه پلاس کسب و کار مدیریت شده که باید از مکان‌های آن استفاده شود. اگر این فیلد تنظیم نشده باشد، از تمام مشاغل قابل دسترسی توسط کاربر (مشخص شده توسط آدرس ایمیل) استفاده می شود. این فیلد فقط دارای جهش است و قابل انتخاب نیست.

categoryFilters[]

string

برای فیلتر کردن فهرست‌های نمایه کسب‌وکار بر اساس دسته‌ها استفاده می‌شود. اگر ورودی‌هایی در دسته‌بندی فیلترها وجود داشته باشد، فقط فهرست‌هایی که به هر یک از دسته‌ها تعلق دارند، کاندیدای همگام‌سازی با 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

مقادیر ممکن برای نوع رابطه برای فید مکان وابسته.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
GENERAL_RETAILER روابط عمومی خرده فروش.