Method: inventory.partners.feeds.record.batchDelete

لحذف سجلات لنوع خلاصة محدّد يُجري عمليات التحقّق الأساسية فقط (مثل الطلب غير الصالح)، وبعد ذلك يتم إرسال الردّ المناسب إلى الشريك على الفور. تجري Google عملية التحقّق من صحة منطق النشاط التجاري في الطلب بشكل غير متزامن. لا يضمن طلب الدفع المجمّع هذا تنفيذ العمليات بشكل متسلسل.

طلب HTTP

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchDelete

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
parent

string

اسم المورد، ويكون بالتنسيق partners/{partner_id}/feeds/{feed_name}.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "records": [
    {
      object (GenericDeleteRecord)
    }
  ]
}
الحقول
records[]

object (GenericDeleteRecord)

سجلات سيتم حذفها يُسمح بتضمين 1,000 سجلّ كحد أقصى في طلب واحد من واجهة برمجة التطبيقات.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة عبارة عن كائن JSON فارغ.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/mapsbooking

GenericDeleteRecord

يجب حذف السجلّ من نوع الخلاصة المذكور في طلب عنوان URL.

تمثيل JSON 
{
  "deleteTime": 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.
}
الحقول
deleteTime

string (Timestamp format)

الحقل مطلوب. يُستخدَم هذا الطابع الزمني لتحديد ترتيب تطبيق عملية الحذف على المستودع الإعلاني.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
حقل الربط record_type تغليف أنواع مختلفة من الخلاصات (ndjson، وproto-based، وما إلى ذلك) يمكن للشريك تقديم سجلّ كامل مشابه لطريقة تقديم السجلّ في خلاصة أو BatchPush API. يمكن للشركاء أيضًا اختيار تضمين الحقول الأساسية فقط في السجلّ المطلوب لتحديده بشكل فريد. يمكن أن يكون التعليق record_type إحدى القيم التالية فقط:
dataRecord

string (bytes format)

بالنسبة إلى الخلاصات غير المستندة إلى بروتوكول.

سلسلة مرمّزة باستخدام Base64
protoRecord

object

بالنسبة إلى الخلاصات المستندة إلى بروتوكول تبادل البيانات

هو كائن يحتوي على حقول من أي نوع، بالإضافة إلى حقل "@type" الذي يتضمّن معرف موارد منتظم (URI) يحدّد نوع الكائن، مثل { "id": 1234, "@type": "types.example.com/standard/id" }.