Nguồn cấp dữ liệu thực thể

Tạo và tải nguồn cấp dữ liệu Thực thể lên

Khi bạn tạo và tải nguồn cấp dữ liệu Thực thể lên, hãy đảm bảo rằng bạn làm theo các hướng dẫn sau:

  • Tuân thủ thông số kỹ thuật được mô tả trong Nguồn cấp dữ liệu thực thể cho các tệp dữ liệu của Thực thể. Bạn phải sử dụng tên tệp dữ liệu Thực thể duy nhất giữa các lần tải lên. Bạn nên thêm dấu thời gian vào tên tệp, ví dụ: Entity1_1633621547.json.
  • Trong chỉ số mô tả tập hợp tệp, hãy đặt trường name thành reservewithgoogle.entity. Để xem ví dụ về tệp mô tả, hãy tham khảo Mẫu JSON của tệp mô tả. Bạn phải sử dụng tên tệp mô tả duy nhất giữa các lần tải lên. Bạn nên thêm dấu thời gian vào tên tệp, ví dụ: Entity1_1633621547.filesetdesc.json. Tệp mô tả phải được tải lên tài khoản đăng SFTP chung.
  • Nguồn cấp dữ liệu phải được tải lên tài khoản đăng SFTP chung hằng ngày dưới dạng làm mới đầy đủ.
  • Bạn có thể tìm thấy thông tin về tài khoản đăng SFTP của nguồn cấp dữ liệu chung trong phần Cấu hình > Nguồn cấp dữ liệu trên cổng thông tin đối tác.

    • Chọn các tài khoản đăng nguồn cấp dữ liệu

  • Bạn có thể xem trạng thái nhập nguồn cấp dữ liệu chung trong phần Nguồn cấp dữ liệu > Nhật ký trên cổng thông tin của đối tác.

Định nghĩa

Định nghĩa EntityFeed

message EntityFeed {
  repeated Entity data = 1;
}

Định nghĩa thực thể

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

Định nghĩa 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;
  }
}

Định nghĩa 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;
}

Mẫu nguồn cấp dữ liệu của thực thể

Nguồn cấp dữ liệu thực thể

Tên tệp : 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"
        }
      }
    }
  ]
}

Tệp mô tả

Tên tệp : entity1_1697754089.filesetdescription.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.entity",
  "data_file": ["entity1_1697754089.json"]
}
Tiếp
Nguồn cấp dữ liệu hành động