Feed entitas

Membuat dan mengupload feed Entitas

Saat membuat dan mengupload feed Entitas, pastikan Anda mengikuti petunjuk berikut:

• Ikuti spesifikasi yang dijelaskan dalam Feed entitas untuk file data Entitas. Anda harus menggunakan nama file data Entitas unik di antara upload. Sebaiknya sertakan stempel waktu dalam nama file, misalnya, Entity1_1633621547.json.
• Pada deskriptor kumpulan file, tetapkan kolom name ke reservewithgoogle.entity. Untuk contoh file deskriptor, lihat Contoh file deskriptor JSON. Anda harus menggunakan nama file deskriptor unik di antara upload. Sebaiknya sertakan stempel waktu dalam nama file, misalnya, Entity1_1633621547.filesetdesc.json. File deskripsi harus diupload ke dropbox SFTP generik.
• Feed harus diupload ke dropbox SFTP generik setiap hari setelah dimuat ulang.
• Anda dapat menemukan info dropbox SFTP feed umum di bagian Konfigurasi > Feed pada portal partner.



• Anda dapat menemukan status penyerapan feed generik di bagian Feed > Histori pada portal partner.

Definisi

Catatan: Spesifikasi feed entity menentukan dalam format protobuf sebagai berikut, tetapi sebaiknya Anda mengupload feed dalam format JSON. Untuk mengetahui informasi lebih lanjut, lihat feed contoh JSON.

Definisi EntityFeed

message EntityFeed {
  repeated Entity data = 1;
}

Definisi entitas

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

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

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

Contoh feed entitas

Feed entitas

Nama file : 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"
        }
      }
    }
  ]
}

File Deskripsi

Nama file : entity1_1697754089.filesetdesc.json

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