Utwórz nowy kontakt i zwróć dla niego zasób osoby.
Jeśli w polu, które jest singlem, określono więcej niż jedno pole w przypadku źródeł kontaktów, żądanie zwraca błąd 400:
- biografie
- urodziny
- płeć
- names
Żądania mutacji dotyczące tego samego użytkownika powinny być wysyłane po kolei, aby uniknąć wydłużenia czasu oczekiwania i niepowodzeń.
Żądanie HTTP
POST https://people.googleapis.com/v1/people:createContact
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
personFields |
To pole jest wymagane. Maska pola określająca, które pola każdej osoby mają być zwracane. Można określić wiele pól, rozdzielając je przecinkami. Jeśli nie zostanie ustawiony, wartość domyślna to wszystkie pola. Prawidłowe wartości to:
|
sources[] |
Opcjonalnie. Maska typów źródeł do zwrócenia. Jeśli nie zostanie ustawiony, domyślna wartość to |
Treść żądania
Treść żądania zawiera wystąpienie elementu Person
.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Person
.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/contacts
Więcej informacji znajdziesz w przewodniku po autoryzacji.