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)

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

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

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

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

object (OAuthInfo)

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

string

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

string

משמש לסינון של הדפים העסקיים ב'פרופיל העסק ב-Google' לפי קטגוריות. אם קיימות רשומות ב-categoryFilters, רק רישומים ששייכים לאחת מהקטגוריות יהיו מועמדים לסנכרון עם FeedItems. אם לא קיימים ערכים ב-categoryFilters, אז כל כרטיסי המוצר מועמדים לסנכרון.
labelFilters[]

string

משמש לסינון הדפים העסקיים בפרופיל העסק לפי תוויות. אם קיימות רשומות ב-labelFilters, רק כרטיסי מוצר שכוללים לפחות אחת מהתוויות שנבחרו זכאים לסנכרון עם FeedItems. אם לא קיימות ערכים ב-labelFilters, אז כל הרישומים יהיו מועמדים לסנכרון.
emailAddress

string

כתובת האימייל של פרופיל העסק או כתובת אימייל של מנהל של פרופיל העסק. חובה.
businessNameFilter

string

משמש לסינון דפים עסקיים ב'פרופיל העסק ב-Google' לפי שם העסק. אם השדה 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 הקשר הכללי של הקמעונאי.