Method: projects.databases.importDocuments

اسناد را به Google Cloud Firestore وارد می کند. اسناد موجود با همین نام رونویسی می شوند. واردات در پس‌زمینه اتفاق می‌افتد و می‌توان پیشرفت آن را از طریق منبع عملیاتی که ایجاد می‌شود، نظارت و مدیریت کرد. اگر عملیات databases.importDocuments لغو شود، ممکن است زیر مجموعه ای از داده ها قبلاً به Cloud Firestore وارد شده باشد.

درخواست HTTP

POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*}:importDocuments

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

ضروری. پایگاه داده برای وارد کردن باید به این شکل باشد: projects/{projectId}/databases/{databaseId} .

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string,
  "namespaceIds": [
    string
  ]
}
زمینه های
collectionIds[]

string

کدام شناسه مجموعه را وارد کنید. نامشخص به معنای تمام مجموعه های موجود در واردات است.

inputUriPrefix

string

محل فایل های صادر شده این باید با outputUriPrefix یک ExportDocumentsResponse از صادراتی که با موفقیت انجام شده است مطابقت داشته باشد. به: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix مراجعه کنید.

namespaceIds[]

string

یک لیست خالی همه فضاهای نام را نشان می دهد. این استفاده ارجح برای پایگاه داده هایی است که از فضای نام استفاده نمی کنند.

یک عنصر رشته خالی نشان دهنده فضای نام پیش فرض است. اگر پایگاه داده دارای داده‌هایی در فضای نام غیر پیش‌فرض است، اما نمی‌خواهد آنها را شامل شود، باید از این مورد استفاده شود. هر فضای نام در این لیست باید منحصر به فرد باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.