Flux d'entités

Créer et importer des flux d'entités

Lorsque vous créez et importez des flux d'entités, veillez à respecter les instructions suivantes:

• Suivez la spécification décrite dans le flux d'entités des fichiers de données d'entité. Vous devez utiliser des noms de fichiers de données d'entité uniques entre les importations. Nous vous recommandons d'inclure un code temporel dans le nom du fichier, par exemple Entity1_1633621547.json.
• Dans le descripteur d'ensemble de fichiers, définissez le champ name sur reservewithgoogle.entity. Pour obtenir un exemple de fichier descripteur, consultez l'exemple JSON de fichier descripteur. Vous devez utiliser des noms de fichiers descripteurs uniques entre les importations. Nous vous recommandons d'inclure un code temporel dans le nom du fichier, par exemple Entity1_1633621547.filesetdesc.json. Le fichier descripteur doit être importé dans la boîte de dépôt SFTP générique.
• Les flux doivent être importés quotidiennement dans la boîte de dépôt SFTP générique lors d'actualisations complètes.
• Vous trouverez des informations génériques sur la boîte de dépôt SFTP dans la section Configuration > Flux du portail des partenaires.



• Vous pouvez consulter l'état générique de l'ingestion de flux dans la section Flux > Historique du portail des partenaires.

Définitions

Remarque:Les spécifications du flux d'entités sont définies au format protobuffer comme suit, mais nous vous recommandons d'importer les flux au format JSON. Pour en savoir plus, consultez les exemples de flux JSON.

Définition de EntityFeed

message EntityFeed {
  repeated Entity data = 1;
}

Définition de l'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. [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;
}

Définition de 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;
  }
}

Définition de l'adresse postale

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

Exemples de flux d'entités

Flux d'entités

Nom de fichier : 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"
        }
      }
    }
  ]
}

Fichier de descripteur

Nom de fichier : entity1_1697754089.filesetdesc.json

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