Feed entità

Creare e caricare feed entità

Quando crei e carichi feed entità, assicurati di seguire queste istruzioni:

  • Segui le specifiche descritte nel feed delle entità per i file di dati delle entità. Devi utilizzare nomi univoci dei file di dati delle entità tra un caricamento e l'altro. È consigliabile includere un timestamp nel nome del file, ad esempio Entity1_1633621547.json.
  • Nel descrittore del set di file, imposta il campo name su reservewithgoogle.entity. Per un esempio del file descrittore, consulta l'esempio di file JSON di esempio. Devi utilizzare nomi di file descrittori univoci tra un caricamento e l'altro. È consigliabile includere un timestamp nel nome del file, ad esempio Entity1_1633621547.filesetdesc.json. Il file descrittore deve essere caricato nella casella personale SFTP generica.
  • I feed devono essere caricati quotidianamente nella casella personale SFTP generica durante gli aggiornamenti completi.
  • Puoi trovare le informazioni generiche sulla casella personale SFTP del feed nella sezione Configurazione > Feed del portale partner.

    • Selezionare le caselle personali dei feed

  • Puoi trovare lo stato di importazione di un feed generico nella sezione Feed > Cronologia del Portale partner.

Definizioni

Definizione di EntityFeed

message EntityFeed {
  repeated Entity data = 1;
}

Definizione di entità

//
// 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. +14567891234. 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;
}

Definizione di GeoCoordinates

// 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;
  }
}

Definizione di 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;
}

Esempi di feed delle entità

Feed entità

Nome file : entity1_1697754089.json

{
  "data": [
    {
      "entity_id": "dining-1",
      "name": "Cucina Venti Restaurant",
      "telephone": "+1-650-254-1120",
      "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"
        }
      }
    }
  ]
}

File descrittore

Nome file : entity1_1697754089.filesetdesc.json

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