Method: projects.databases.exportDocuments

ייצוא עותק של כל המסמכים או של קבוצת משנה שלהם מ-Google Cloud Firestore למערכת אחסון אחרת, כמו Google Cloud Storage. ייתכן שהעדכונים האחרונים במסמכים לא יבואו לידי ביטוי בייצוא. הייצוא מתרחש ברקע, ואפשר לעקוב אחר ההתקדמות שלו ולנהל אותה באמצעות משאב הפעולה שנוצר. אפשר להשתמש בפלט של ייצוא רק לאחר סיום הפעולה המשויכת. אם פעולת ייצוא מתבטלת לפני הסיום, היא עלולה להשאיר נתונים חלקיים ב-Google Cloud Storage.

בקשת HTTP

POST https://firestore.googleapis.com/v1beta1/{name=projects/*/databases/*}:exportDocuments

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
name

string

מסד הנתונים לייצוא. הוא אמור להופיע בפורמט: projects/{projectId}/databases/{databaseId}.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "collectionIds": [
    string
  ],
  "outputUriPrefix": string
}
שדות
collectionIds[]

string

אילו מזהי אוספים לייצא אם לא צוין אחרת, המשמעות היא כל האוספים.
outputUriPrefix

string

ה-URI של הפלט. נכון לעכשיו יש תמיכה במזהי URI של Google Cloud Storage בצורה הבאה: gs://BUCKET_NAME[/NAMESPACE_PATH], כאשר BUCKET_NAME הוא השם של הקטגוריה של Google Cloud Storage ו-NAMESPACE_PATH הוא נתיב אופציונלי של מרחב שמות ב-Google Cloud Storage. כשבוחרים שם, חשוב לפעול לפי ההנחיות למתן שמות ל-Google Cloud Storage: https://cloud.google.com/storage/docs/naming. אם ה-URI הוא קטגוריה (ללא נתיב מרחב שמות), תיווצר קידומת על סמך שעת ההתחלה.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של Operation.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

מידע נוסף זמין בסקירה הכללית על אימות.