פיד פעולות

יצירה והעלאה של פידים של פעולות

כשיוצרים ומעלים פידים של פעולות, צריך לפעול לפי ההוראות הבאות:

  • פועלים לפי המפרט שמתואר בפיד הפעולות לגבי קובצי נתוני פעולות. מומלץ להשתמש בשמות ייחודיים של קובצי נתוני פעולות לכל העלאה. כוללים חותמת זמן בשם הקובץ, לדוגמה, action_1633621547.json.
  • בתיאור של קבוצת הקבצים, מגדירים את השדה name לערך reservewithgoogle.action.v2. דוגמה לקובץ התיאור מופיעה בדוגמת ה-JSON. מומלץ להשתמש בשמות ייחודיים של קובצי תיאור לכל העלאה. כוללים חותמת זמן בשם הקובץ, לדוגמה, action_1633621547.filesetdesc.json. צריך להעלות את קובץ התיאור לשרת SFTP גנרי.
  • להעלות פידים לשרת SFTP כללי מדי יום כעדכונים מלאים.
  • פרטי שרת SFTP מופיעים בקטע הגדרה > פידים בפורטל השותפים.
  • בחירת שרתי פיד

    בחירת שרתים של פידים בפורטל לשותפים
  • אפשר לראות את סטטוס הטמעת הפיד בקטע פידים > היסטוריה בפורטל השותפים.

הגדרות

הגדרה של פיד פעולות

message ActionFeed {
  repeated ActionDetail data = 1;
}

הגדרה של ActionDetail

message ActionDetail {
  string entity_id = 2;
  string link_id = 3;

  // Deep link for action detail
  string url = 4;
  repeated Action actions = 1;
}

הגדרת הפעולה

// Information about an Action which could be performed.
message Action {
  // Deprecated fields not to be reused.
  reserved 1;

  oneof action_info {
    FoodOrderingInfo food_ordering_info = 3;
  }
}

הגדרה של FoodOrderingInfo

message FoodOrderingInfo {
  // Service type for food ordering action.
  enum ServiceType {
    UNKNOWN = 0;
    DELIVERY = 1;
    TAKEOUT = 2;
  }

  ServiceType service_type = 1
      ;
}

דוגמאות לפיד הפעולות

משלוח בלבד

שם הקובץ : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "DELIVERY" } }],
      "entity_id": "dining-1",
      "link_id": "delivery-dining-1",
      "url": "https://www.restaurant.com/delivery/dining-1"
    }
  ]
}

איסוף עצמי בלבד

שם הקובץ : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }],
      "entity_id": "dining-1",
      "link_id": "takeout-link-dining-1",
      "url": "https://www.restaurant.com/takeout/dining-1"
    }
  ]
}

משלוח ואיסוף עצמי

שם הקובץ : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [
        { "food_ordering_info": { "service_type": "DELIVERY" } },
        { "food_ordering_info": { "service_type": "TAKEOUT" } }
      ],
      "entity_id": "dining-1",
      "link_id": "common-link-dining-1",
      "url": "https://www.restaurant.com/commonlink/dining-1"
    }
  ]
}

כתובת URL שונה למשלוח ולאיסוף עצמי

שם הקובץ : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "TAKEOUT"
          }
        }
      ],
      "entity_id": "dining-1",
      "link_id": "takeout-dining-1",
      "url": "https://www.restaurant.com/takeout/dining-1"
    },
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "DELIVERY"
          }
        }
      ],
      "entity_id": "dining-1",
      "link_id": "delivery-dining-1",
      "url": "https://www.restaurant.com/delivery/dining-1"
    }
  ]
}

קובץ תיאור

שם הקובץ : actions_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": [
    "actions_1697754089_0001.json",
    "actions_1697754089_0002.json"
  ]
}