Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Crea y sube feeds de entidades
Cuando crees y subas feeds de entidades, sigue estas instrucciones:
Sigue las especificaciones que se describen en el feed de entidades para los archivos de datos de entidades. Te recomendamos que uses nombres de archivo de datos de entidades únicos para cada carga.
Incluye una marca de tiempo en el nombre del archivo, por ejemplo, entity_1633621547.json.
En el descriptor del conjunto de archivos, establece el campo name en reservewithgoogle.entity. Para ver un ejemplo del archivo de descriptor, consulta el ejemplo en JSON.
Te recomendamos que uses nombres de archivo de descriptor únicos para cada carga.
Incluye una marca de tiempo en el nombre del archivo, por ejemplo, entity_1633621547.filesetdesc.json.
El archivo descriptor se debe subir al servidor SFTP genérico.
Sube feeds al servidor de SFTP genérico todos los días como actualizaciones completas.
Puedes encontrar los detalles del servidor SFTP en la sección
Configuración > Feeds del Partner Portal.
Cómo seleccionar servidores de feeds en el Partner Portal
Consulta el estado de la transferencia del feed en la sección
Feeds > History del Partner Portal.
Definiciones
Definición de EntityFeed
messageEntityFeed{repeatedEntitydata=1;}
Definición de la entidad
//// 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.messageEntity{// 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)stringentity_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)stringname=2;// The contact telephone number of the Entity including its country and area// codes, e.g. +14567891234. Highly recommended. (optional)stringtelephone=3;// The url of the Entity's public website. Highly recommended. (optional)stringurl=4;// The location of the Entity (required)madden.ingestion.GeoCoordinateslocation=5;// This field is used by the aggregator to define which Brand should be// applied to which entity. (optional)stringaggregator_brand_id=6;}
Definición de 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).messageGeoCoordinates{// [-90, +90] degrees (inclusive). (optional)doublelatitude=1;// [-180, +180] degrees (inclusive). (optional)doublelongitude=2;// Address for a location, could either be structured or unstructured.oneofaddresses{// Postal address of the location, preferred.PostalAddressaddress=3;// An unstructured address could also be provided as a fallback.// E.g. "1600 amphitheatre parkway mountain view, ca 94043"stringunstructured_address=4;}}
Definición de PostalAddress
// The postal address for a merchant.messagePostalAddress{// The country, using ISO 3166-1 alpha-2 country code, e.g. "US" (required)stringcountry=1;// The locality/city, e.g. "Mountain View". (required)stringlocality=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)stringregion=3;// The postal code, e.g. "94043". (required)stringpostal_code=4;// The street address, e.g. "1600 Amphitheatre Pkwy". (required)stringstreet_address=5;}
Muestras de feeds de entidades
Feed de entidades
{"data":[{"entity_id":"appointments-merchant-1","name":"Lorem ipsum Barbershop","telephone":"+11111222233","url":"https://barbershop.com","location":{"latitude":37.422113,"longitude":-122.084041,"address":{"country":"US","locality":"Mountain View","region":"California","postal_code":"94043","street_address":"1600 Amphitheater Drive"}}}]}
[null,null,["Última actualización: 2025-08-06 (UTC)"],[[["\u003cp\u003eEntity feeds should be uploaded in JSON format, although they are defined using Protobuf.\u003c/p\u003e\n"],["\u003cp\u003eEach entity in the feed represents a real-world place like a store or business, uniquely identified by \u003ccode\u003eentity_id\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEssential entity information includes name, location (latitude/longitude or address), and optionally telephone and website URL.\u003c/p\u003e\n"],["\u003cp\u003eLocation can be specified using latitude/longitude coordinates or a structured/unstructured postal address.\u003c/p\u003e\n"],["\u003cp\u003eA descriptor file accompanies the entity feed, listing associated data files and a timestamp.\u003c/p\u003e\n"]]],["Partners upload entity feeds in JSON format, defining each `Entity` with a unique `entity_id`, `name`, and `location`. `telephone` and `url` are optional but recommended. `location` requires `latitude`/`longitude` or a `PostalAddress` (or both), the latter including `country`, `locality`, `postal_code`, and `street_address`. An `EntityFeed` contains a list of `Entity` data. Descriptor file contains `generation_timestamp`, `name` and `data_file`.\n"],null,["Create and upload entity feeds\n\nWhen creating and uploading entity feeds, follow these instructions:\n\n- Follow the spec described in the [entity feed](#EntityFeed-definition) 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`.\n- In the fileset descriptor, set the `name` field to `reservewithgoogle.entity`. For an example of the descriptor file, refer to the [JSON sample](#descriptor-file). 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.\n- Upload feeds to the generic SFTP server daily as full refreshes.\n- You can find SFTP server details in the [Configuration \\\u003e Feeds](https://partnerdash.google.com/apps/reservewithgoogle/configuration/feeds) section of the Partner Portal.\n\n\nSelecting feed servers in the Partner Portal\n- View feed ingestion status in the [Feeds \\\u003e History](https://partnerdash.google.com/apps/reservewithgoogle/dashboards/feeds) section of the Partner Portal.\n\nDefinitions **Note:** The Entity feed spec is defined in protobuffer format below, however we recommend uploading the feeds in JSON format. You can reference our [JSON sample feeds](#samples) for more information.\n\nEntityFeed Definition \n\n```protobuf\nmessage EntityFeed {\n repeated Entity data = 1;\n}\n```\n\nEntity Definition \n\n```protobuf\n//\n// Information about an Entity that is on the partner's platform. For example,\n// an Entity could be a retail store, a hospital, an online business etc.\nmessage Entity {\n // An opaque string generated by the partner that identifies an Entity.\n // Must be unique across all entities.\n // Strongly recommended to only include URL-safe characters. (required)\n string entity_id = 1;\n\n // If present, the name, telephone, url and location are used to support\n // matching partner inventory with entities already present on Google. This\n // information will not be displayed.\n\n // The name of the Entity. (required)\n string name = 2;\n\n // The contact telephone number of the Entity including its country and area\n // codes, e.g. +14567891234. Highly recommended. (optional)\n string telephone = 3;\n\n // The url of the Entity's public website. Highly recommended. (optional)\n string url = 4;\n\n // The location of the Entity (required)\n madden.ingestion.GeoCoordinates location = 5;\n\n // This field is used by the aggregator to define which Brand should be\n // applied to which entity. (optional)\n string aggregator_brand_id = 6;\n}\n```\n\nGeoCoordinates Definition \n\n```protobuf\n// The Geo data of a location, including latitude, longitude, and address.\n// At least one of [lat/lng or address] should be provided (or both).\nmessage GeoCoordinates {\n // [-90, +90] degrees (inclusive). (optional)\n double latitude = 1;\n\n // [-180, +180] degrees (inclusive). (optional)\n double longitude = 2;\n\n // Address for a location, could either be structured or unstructured.\n oneof addresses {\n // Postal address of the location, preferred.\n PostalAddress address = 3;\n\n // An unstructured address could also be provided as a fallback.\n // E.g. \"1600 amphitheatre parkway mountain view, ca 94043\"\n string unstructured_address = 4;\n }\n}\n```\n\nPostalAddress Definition \n\n```protobuf\n// The postal address for a merchant.\nmessage PostalAddress {\n // The country, using ISO 3166-1 alpha-2 country code, e.g. \"US\" (required)\n string country = 1;\n\n // The locality/city, e.g. \"Mountain View\". (required)\n string locality = 2;\n\n // The region/state/province, e.g. \"CA\". This field is only required in\n // countries where region is commonly a part of the address. (optional)\n string region = 3;\n\n // The postal code, e.g. \"94043\". (required)\n string postal_code = 4;\n\n // The street address, e.g. \"1600 Amphitheatre Pkwy\". (required)\n string street_address = 5;\n}\n```\n\nEntity feeds samples \n\nEntity Feed \n\n```protobuf\n{\n \"data\": [\n {\n \"entity_id\": \"appointments-merchant-1\",\n \"name\": \"Lorem ipsum Barbershop\",\n \"telephone\": \"+11111222233\",\n \"url\": \"https://barbershop.com\",\n \"location\": {\n \"latitude\": 37.422113,\n \"longitude\": -122.084041,\n \"address\": {\n \"country\": \"US\",\n \"locality\": \"Mountain View\",\n \"region\": \"California\",\n \"postal_code\": \"94043\",\n \"street_address\": \"1600 Amphitheater Drive\"\n }\n }\n }\n ]\n}\n```\n\nDescriptor File \n\n```protobuf\n{\n \"generation_timestamp\": 1677545962,\n \"name\": \"reservewithgoogle.entity\",\n \"data_file\": [\n \"entity_1677545962_0001.json\",\n \"entity_1677545962_0002.json\"\n\n ]\n}\n```"]]