פיד ישויות

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

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

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



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

הגדרות

הערה: המפרט של פיד הישויות מוגדר בפורמט protobuffer באופן הבא, אבל מומלץ להעלות את הפידים בפורמט JSON. למידע נוסף, קראו את המאמר פידים לדוגמה מסוג JSON.

ההגדרה של EntityFeed

message EntityFeed {
  repeated Entity data = 1;
}

הגדרת הישות

//
// Information about an Entity that is on the partner's platform. For example,
// an Entity could be a retail store, a hospital, an online business etc.
message Entity {
  // An opaque string generated by the partner that identifies an Entity.
  // Must be unique across all entities.
  // Strongly recommended to only include URL-safe characters. (required)
  string entity_id = 1;

  // If present, the name, telephone, url and location are used to support
  // matching partner inventory with entities already present on Google. This
  // information will not be displayed.

  // The name of the Entity. (required)
  string name = 2;

  // The contact telephone number of the Entity including its country and area
  // codes, e.g. [phone]. Highly recommended. (optional)
  string telephone = 3;

  // The url of the Entity's public website. Highly recommended. (optional)
  string url = 4;

  // The location of the Entity (required)
  madden.ingestion.GeoCoordinates location = 5;
}

הגדרת קואורדינטות גיאוגרפיות

// The Geo data of a location, including latitude, longitude, and address.
// At least one of [lat/lng or address] should be provided (or both).
message GeoCoordinates {
  double latitude = 1;   // In degrees. (optional)
  double longitude = 2;  // In degrees. (optional)

  // Address for a location, could either be structured or unstructured.
  oneof addresses {
    // Postal address of the location, preferred.
    PostalAddress address = 3;
    // An unstructured address could also be provided as a fallback.
    // E.g. "1600 amphitheatre parkway mountain view, ca 94043"
    string unstructured_address = 4;
  }
}

הגדרת PostalAddress

// The postal address for a merchant.
message PostalAddress {
  // The country, using ISO 3166-1 alpha-2 country code, e.g. "US" (required)
  string country = 1;
  // The locality/city, e.g. "Mountain View". (required)
  string locality = 2;
  // The region/state/province, e.g. "CA". This field is only required in
  // countries where region is commonly a part of the address. (optional)
  string region = 3;
  // The postal code, e.g. "94043". (required)
  string postal_code = 4;
  // The street address, e.g. "1600 Amphitheatre Pkwy". (required)
  string street_address = 5;
}

דוגמאות לפידים של ישויות

פיד ישויות

שם קובץ : entity1_1697754089.json

{
  "data": [
    {
      "entity_id": "dining-1",
      "name": "Cucina Venti Restaurant",
      "telephone": "[phone]",
      "url": "www.cucinaventi.com",
      "location": {
        "latitude": 37.41611,
        "longitude": -122.07751,
        "address": {
          "country": "US",
          "locality": "Mountain View",
          "region": "CA",
          "postal_code": "94043",
          "street_address": "1390 Pear Ave ste D"
        }
      }
    }
  ]
}

קובץ מתאר

שם קובץ : entity1_1697754089.filesetארט.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.entity",
  "data_file": ["entity1_1697754089.json"]
}