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. כדי להוסיף מאפיינים חדשים, צריך להשתמש ב-attributeOperations.
attributeOperations[]

object (FeedAttributeOperation)

רשימת הפעולות שמשנות את מאפייני הפיד. אפשר רק להוסיף מאפיינים, אבל אי אפשר להסיר אותם.
origin

enum (FeedOrigin)

בלתי משתנה. מציין מי מנהל את מאפייני הפיד של הפיד.
status

enum (FeedStatus)

פלט בלבד. הסטטוס של הפיד. השדה הזה הוא לקריאה בלבד.
id

string (int64 format)

פלט בלבד. מזהה הפיד. השדה הזה הוא לקריאה בלבד.
name

string

בלתי משתנה. שם הפיד. חובה.
שדה איחוד system_feed_generation_data. נתוני המערכת של הפיד. הנתונים האלה מציינים את המידע הנדרש ליצירת הפריטים בפיד של הפיד שנוצר על ידי המערכת. system_feed_generation_data יכול להיות רק אחד מהבאים:
placesLocationFeedData

object (PlacesLocationFeedData)

נתונים שמשמשים להגדרת פיד מיקומים שמאוכלס מ'פרופיל העסק ב-Google'.
affiliateLocationFeedData

object (AffiliateLocationFeedData)

נתונים שמשמשים להגדרת פיד של מיקומים מקושרים שמאוכלס ברשתות שצוינו.

FeedAttribute

מאפייני פיד מגדירים את סוגי הנתונים שצפויים להופיע בפיד. מאפיין 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

מציין שהנתונים התואמים למאפיין הזה הם חלק מהמפתח הייחודי של פריט בפיד. אם לא מציינים את הפרמטר הזה, ברירת המחדל שלו היא False. הערה: לא נדרש מפתח ייחודי בסכימה של פיד. במקרה כזה, צריך להפנות לפריטי הפיד באמצעות feed_item_id.

FeedAttributeType

סוגי נתונים אפשריים למאפיין פיד.

טיפוסים בני מנייה (enums)
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)

פלט בלבד. מאפיין הפיד שמתווסף לרשימה.

מפעיל

האופרטור.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
ADD מוסיפים את המאפיין למאפיינים הקיימים.

FeedOrigin

ערכים אפשריים למקור הפיד.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
USER מאפייני הפיד של הפיד הזה מנוהלים על ידי המשתמש. משתמשים יכולים להוסיף מאפייני פיד אל הפיד הזה.
GOOGLE מאפייני העדכון עבור עדכון של GOOGLE נוצרים על ידי Google. פיד מהסוג הזה מנוהל על ידי Google, והוא יכלול את המאפיינים המתאימים לסוג ה-placeholder של הפיד.

FeedStatus

סטטוסים אפשריים של פיד.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
ENABLED הפיד מופעל.
REMOVED הפיד הוסר.

PlacesLocationFeedData

נתונים שמשמשים להגדרת פיד מיקומים שמאוכלס מ'פרופיל העסק ב-Google'.

ייצוג JSON 
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
שדות
oauthInfo

object (OAuthInfo)

בלתי משתנה. אסימון אימות שנדרש (מ-OAuth API) לאימייל. אפשר לציין את השדה הזה רק בבקשת יצירה. לא ניתן לבחור את כל שדות המשנה שלו.
businessAccountId

string

מזהה דף הפלוס של העסק המנוהל שיש להשתמש במיקומים שלו. אם לא מגדירים את השדה הזה, ייעשה שימוש בכל העסקים שאליהם המשתמש יכול לגשת (לפי כתובת האימייל). השדה הזה ניתן לשינוי בלבד ולא ניתן לבחור בו.
categoryFilters[]

string

משמש לסינון הדפים העסקיים בפרופיל העסק לפי קטגוריות. אם קיימים ערכים ב-categoryFilters, המערכת תוכל לסנכרן עם פריטי FeedItem רק כרטיסי מוצר ששייכים לאחת מהקטגוריות. אם לא קיימות רשומות ב-categoryFilters, כל דפי האפליקציה יהיו מועמדים לסנכרון.
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 הקשר הכללי של הקמעונאי.