實體動態饋給

建立及上傳實體動態饋給

建立及上傳實體動態饋給時，請按照下列操作說明進行：

  • 請按照實體動態饋給所述規格，處理實體資料檔案。建議您為每次上傳作業使用專屬的實體資料檔名。 在檔案名稱中加入時間戳記，例如 Entity_1633621547.json。
  • 在檔案集描述元中，將 name 欄位設為 reservewithgoogle.entity。如需描述元檔案範例，請參閱 JSON 範例。 建議您為每次上傳作業使用專屬的描述元檔案名稱。 在檔案名稱中加入時間戳記，例如 Entity_1633621547.filesetdesc.json。 描述元檔案必須上傳至一般 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.
  // This ID should be immutable. Changing or recycling them to represent the
  // same entity may cause issues and outages.
  // (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 {
  // [-90, +90] degrees (inclusive). (optional)
  double latitude = 1;

  // [-180, +180] degrees (inclusive). (optional)
  double longitude = 2;

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

實體動態饋給範例

用餐

檔案名稱：entity_1697754089_0001.json

{
  "data": [
    {
      "entity_id": "dining-1",
      "name": "Sample Eatery 1",
      "telephone": "+1-415-876-5432",
      "url": "www.sampleeatery1.com",
      "location": {
        "latitude": 37.404570,
        "longitude": -122.033160,
        "address": {
          "country": "US",
          "locality": "Sunnyvale",
          "region": "CA",
          "postal_code": "94089",
          "street_address": "815 11th Ave"
        }
      }
    },
    {
      "entity_id": "dining-2",
      "name": "Sample Eatery 2",
      "telephone": "+1-415-123-4567",
      "url": "www.sampleeatery2.com",
      "location": {
        "latitude": 37.422113,
        "longitude": -122.084041,
        "address": {
          "country": "US",
          "locality": "Sunnyvale",
          "region": "CA",
          "postal_code": "94089",
          "street_address": "805 11th Ave"
        }
      }
    }
  ]
}

訂餐

檔案名稱：entity_1697754089_0001.json

{
  "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
  },
  "merchant": [
    {
      "merchant_id": "dining-starter-2",
      "name": "Sample Bakery",
      "telephone": "+1-415-124-4567",
      "url": "www.starterdining2publicsite.com",
      "category": "restaurant",
      "geo": {
        "latitude": 37.422113,
        "longitude": -122.084041,
        "address": {
          "street_address": "805 11th Ave",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "US",
          "postal_code": "94089"
        }
      }
    }
  ]
}

購物

檔案名稱：entity_1697754089_0001.json

{
  "data": [
    {
      "entity_id": "apparel-brand-store-1",
      "name": "Apparel Brand Store - Downtown",
      "telephone": "+1-415-876-0001",
      "url": "www.apparel-brand-example.com/store/1",
      "location": {
        "latitude": 37.404570,
        "longitude": -122.033160,
        "address": {
          "country": "US",
          "locality": "Sunnyvale",
          "region": "CA",
          "postal_code": "94089",
          "street_address": "700 11th Ave"
        }
      }
    },
    {
      "entity_id": "footwear-brand-store-1",
      "name": "Footwear Brand Store - City Center",
      "telephone": "+1-415-123-0002",
      "url": "www.footwear-brand-example.com/store/1",
      "location": {
        "latitude": 37.422113,
        "longitude": -122.084041,
        "address": {
          "country": "US",
          "locality": "Sunnyvale",
          "region": "CA",
          "postal_code": "94089",
          "street_address": "800 11th Ave"
        }
      }
    }
  ]
}

描述元 (所有產業)

檔案名稱：entity_1697754089.filesetdesc.json

{
  "generation_timestamp": 1692998244,
  "name": "reservewithgoogle.entity",
  "data_file": [
    "entity_1697754089_0001.json"
  ]
}