항목 피드

항목 피드 만들기 및 업로드

항목 피드를 만들고 업로드할 때 다음 안내를 따라야 합니다.

  • 항목 데이터 파일의 경우 항목 피드에 설명된 사양을 따르세요. 업로드 간에 고유한 엔티티 데이터 파일 이름을 사용해야 합니다. 파일 이름에 타임스탬프(예: Entity1_1633621547.json)를 포함하는 것이 좋습니다.
  • 파일 세트 설명자에서 name 필드를 reservewithgoogle.entity로 설정합니다. 설명자 파일의 예는 설명자 파일 JSON 샘플을 참고하세요. 업로드 사이에 고유한 설명자 파일 이름을 사용해야 합니다. 파일 이름에 타임스탬프(예: Entity1_1633621547.filesetdesc.json)를 포함하는 것이 좋습니다. 설명자 파일은 일반 SFTP 보관용 계정에 업로드해야 합니다.
  • 피드는 전체 새로고침으로 매일 일반 SFTP 보관용 계정에 업로드해야 합니다.
  • 파트너 포털의 구성 > 피드 섹션에서 일반 피드 SFTP 보관용 계정 정보를 확인할 수 있습니다.

    • 피드 보관용 계정 선택

  • 파트너 포털의 피드 > 기록 섹션에서 일반 피드 처리 상태를 확인할 수 있습니다.

정의

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

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

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

설명어 파일

파일 이름 : entity1_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.entity",
  "data_file": ["entity1_1697754089.json"]
}
다음
작업 피드