Method: projects.databases.documents.createDocument

Tworzy nowy dokument.

Żądanie HTTP

POST https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*/documents/**}/{collectionId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

To pole jest wymagane. Zasób nadrzędny. Na przykład: projects/{projectId}/databases/{databaseId}/documents lub projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}

collectionId

string

To pole jest wymagane. Identyfikator kolekcji względem parent, do listy. Na przykład: chatrooms.

Parametry zapytania

Parametry
documentId

string

Przypisany przez klienta identyfikator dokumentu, który ma być używany w tym dokumencie.

Opcjonalnie. Jeśli go nie podasz, usługa otrzyma identyfikator.

mask

object (DocumentMask)

Pola do zwrócenia. Jeśli zasada nie jest skonfigurowana, zwraca wszystkie pola.

Jeśli dokument zawiera pole, którego nie ma w tej masce, nie zostanie ono zwrócone w odpowiedzi.

Treść żądania

Treść żądania zawiera instancję Document.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała instancję Document.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w artykule o uwierzytelnianiu (w języku angielskim).