Method: inventory.partners.feeds.record.batchPush
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
插入和/或更新指定 Feed 类型的记录。仅执行基本验证（例如格式错误的请求），之后会立即将适当的响应返回给合作伙伴。Google 会以异步方式对请求执行业务逻辑验证。此批量调用不保证原子性。
HTTP 请求
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchPush
网址采用 gRPC 转码语法。
路径参数
| 参数 |
parent |
string
资源名称，格式为 - partners/{partner_id}/feeds/{feed_name}。
|
请求正文
请求正文中包含结构如下的数据：
| 字段 |
records[] |
object (GenericRecord)
要插入和/或更新的记录。一个 API 调用中最多允许 1000 条记录。
|
授权范围
需要以下 OAuth 范围：
https://www.googleapis.com/auth/mapsbooking
GenericRecord
| 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.
} |
| 字段 |
generationTimestamp |
string (Timestamp format)
必需。此时间戳用于确保商品目录更新按正确的顺序排列。 时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
|
联合字段 record_type。封装不同类型的 Feed（ndjson、基于 proto 等）record_type 只能是下列其中一项： |
dataRecord |
string (bytes format)
适用于非基于 proto 的 Feed。 使用 base64 编码的字符串。
|
protoRecord |
object
适用于基于 Proto 的 Feed。 此对象可以包含任意类型的字段。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。
|
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-24。
[null,null,["最后更新时间 (UTC)：2025-07-24。"],[[["\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\" }`. |"]]
