Method: inventory.partners.feeds.record.batchPush
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Insère et/ou met à jour les enregistrements du type de flux spécifié. Effectue uniquement une validation de base (comme une requête incorrecte), après quoi une réponse appropriée est immédiatement renvoyée au partenaire. Google effectue la validation de la logique métier de la requête de manière asynchrone. Cet appel par lot ne garantit pas l'atomicité.
Requête HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchPush
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
parent |
string
Nom de la ressource, au format partners/{partner_id}/feeds/{feed_name}.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"records": [
{
object (GenericRecord)
}
]
} |
| Champs |
records[] |
object (GenericRecord)
Enregistrements à insérer et/ou à mettre à jour. Un appel d'API peut comporter jusqu'à 1 000 enregistrements.
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse est vide.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/mapsbooking
GenericRecord
Enregistrement du type de flux mentionné dans la requête d'URL.
| Représentation JSON |
{
"generationTimestamp": string,
// Union field record_type can be only one of the following:
"dataRecord": string,
"protoRecord": {
"@type": string,
field1: ...,
...
}
// End of list of possible types for union field record_type.
} |
| Champs |
generationTimestamp |
string (Timestamp format)
Obligatoire. Ce code temporel permet de garantir l'ordre correct des mises à jour de l'inventaire. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
|
Champ d'union record_type. Encapsuler différents types de flux (ndjson, proto-basé, etc.) record_type ne peut être qu'un des éléments suivants : |
dataRecord |
string (bytes format)
Pour les flux non basés sur le protocole. Chaîne encodée en base64.
|
protoRecord |
object
Pour les flux basés sur le protocole proto. Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/24 (UTC).
[null,null,["Dernière mise à jour le 2025/07/24 (UTC)."],[[["\u003cp\u003eInserts or updates records for a specified feed type using batch calls, which do not guarantee atomicity.\u003c/p\u003e\n"],["\u003cp\u003eSupports two types of records: dataRecord (base64-encoded string) and protoRecord (arbitrary object with a type identifier).\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/mapsbooking\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eMaximum of 1000 records are allowed per API call.\u003c/p\u003e\n"],["\u003cp\u003eGoogle performs business logic validation asynchronously, and basic validation is performed synchronously with an immediate response.\u003c/p\u003e\n"]]],[],null,["# Method: inventory.partners.feeds.record.batchPush\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [GenericRecord](#GenericRecord)\n - [JSON representation](#GenericRecord.SCHEMA_REPRESENTATION)\n\nInserts and/or updates records of specified feed type. Only performs basic validation (like malformed request) after which an appropriate response is returned to the partner immediately. Google performs business logic validation on the request asynchronously. This batch call does not guarantee atomicity.\n\n### HTTP request\n\n`POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchPush`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------|\n| `parent` | `string` Resource name, which has the format of - `partners/{partner_id}/feeds/{feed_name}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"records\": [ { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.feeds.record/batchPush#GenericRecord) } ] } ``` |\n\n| Fields ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `records[]` | `object (`[GenericRecord](/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.feeds.record/batchPush#GenericRecord)`)` Records to be inserted and/or updated. Maximum of 1000 records are allowed in one api call. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/mapsbooking`\n\nGenericRecord\n-------------\n\nRecord of the feed type mentioned in url request.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"generationTimestamp\": string, // Union field `record_type` can be only one of the following: \"dataRecord\": string, \"protoRecord\": { \"@type\": string, field1: ..., ... } // End of list of possible types for union field `record_type`. } ``` |\n\n| Fields ||\n|-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `generation``Timestamp` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Required. This timestamp is used to to ensure correct ordering of inventory updates. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| Union field `record_type`. Encapsulate different types of feed (ndjson, proto-based, etc.) `record_type` can be only one of the following: ||\n| `data``Record` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` For non-proto based feeds. A base64-encoded string. |\n| `proto``Record` | `object` For proto-based feeds. An object containing fields of an arbitrary type. An additional field `\"@type\"` contains a URI identifying the type. Example: `{ \"id\": 1234, \"@type\": \"types.example.com/standard/id\" }`. |"]]
