建立及上傳實體動態饋給
建立和上傳實體動態饋給時,請務必遵循下列操作說明:
- 遵循實體資料檔案實體動態饋給中所述的規格。不同的上傳項目必須使用不重複的實體資料檔案名稱。建議您在檔案名稱中加入時間戳記,例如
Entity1_1633621547.json
。 - 在檔案集描述元中,將
name
欄位設為reservewithgoogle.entity
。如需描述元檔案範例,請參閱描述元檔案 JSON 範例。請務必在上傳檔案之間使用不重複的描述元檔案名稱。建議您在檔案名稱中加入時間戳記,例如Entity1_1633621547.filesetdesc.json
。描述元檔案必須上傳至一般的 SFTP Dropbox。 - 您必須每天將動態饋給上傳至一般 SFTP 投寄箱,才能完成完整更新。
- 如要查看一般動態饋給的 SFTP Dropbox 資訊,請前往合作夥伴入口網站的「設定」>「動態饋給」專區。
- 如要查看一般動態饋給擷取狀態,請前往合作夥伴入口網站的「動態饋給」>「記錄」部分。
定義
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"] }