Create and upload Entity feeds
When creating and uploading Entity feeds, follow these instructions:
- Follow the spec described in the Entity feed
for Entity data files. We recommend using unique Entity data file names for each upload.
Include a timestamp in the filename, for example,
Entity_1633621547.json. - In the fileset descriptor, set the
namefield toreservewithgoogle.entity. For an example of the descriptor file, refer to the JSON sample . We recommend using unique descriptor file names for each upload. Include a timestamp in the filename, for example,Entity_1633621547.filesetdesc.json. The descriptor file must be uploaded to the generic SFTP server. - Upload feeds to the generic SFTP server daily as full refreshes.
- You can find SFTP server details in the Configuration > Feeds section of the Partner Portal.
- View feed ingestion status in the Feeds > History section of the Partner Portal.

Definitions
EntityFeed definition
message EntityFeed { repeated Entity data = 1 ; }
Entity definition
// // 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 ; // This field is used by the aggregator to define which Brand should be // applied to which entity. (optional) string aggregator_brand_id = 6 ; }
GeoCoordinates definition
// 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 definition
// 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 feed samples
Entity
{
"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"
}
}
}
]
}
File Descriptor
{
"generation_timestamp"
:
1692998244
,
"name"
:
"google.entity"
,
"data_file"
:
[
"entity_1697754089_0001.json"
]
}

