Method: inventory.partners.feeds.record.batchPush
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إدراج و/أو تعديل سجلّات نوع خلاصة محدّد لا تُجري هذه العملية سوى عمليات التحقّق الأساسية (مثل طلب غير صحيح الشكل)، وبعد ذلك يتم عرض ردّ مناسب على الشريك على الفور. تُجري Google عمليات تحقُّق من منطق النشاط التجاري على الطلب بشكلٍ غير متزامن. لا يضمن هذا الطلب المجمّع الاتزان.
طلب HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchPush
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
اسم المورد، بتنسيق - partners/{partner_id}/feeds/{feed_name}
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
records[] |
object (GenericRecord)
السجلّات التي سيتم إدراجها و/أو تعديلها. يُسمح بـ 1,000 سجلّ كحد أقصى في استدعاء واجهة برمجة التطبيقات واحد.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/mapsbooking
GenericRecord
سجلّ نوع الخلاصة المذكور في طلب عنوان URL.
| تمثيل 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 "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
|
حقل الاتحاد record_type. تجميع أنواع مختلفة من الخلاصات (ndjson وproto-based وما إلى ذلك) يمكن أن يكون record_type واحدًا فقط مما يلي: |
dataRecord |
string (bytes format)
للخلاصات غير المستندة إلى أولي. سلسلة بترميز base64
|
protoRecord |
object
للخلاصات المستندة إلى النماذج كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي "@type" على معرف موارد منتظم (URI) يحدد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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\" }`. |"]]
