Method: people.batchCreateContacts

Utwórz grupę nowych kontaktów i zwróć wartości PersonResponse dla nowo

Żą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:batchCreateContacts

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Pola
contacts[]

object (ContactToCreate)

To pole jest wymagane. Kontakt do utworzenia. Pozwala na wysłanie do 200 kontaktów w jednym żądaniu.
readMask

string (FieldMask format)

To pole jest wymagane. Maska pola określająca, które pola każdej osoby mają być zwracane w odpowiedzi. Można określić wiele pól, rozdzielając je przecinkami. Jeśli maska odczytu jest pusta, metoda post-mutate-get jest pomijana i w odpowiedzi nie są zwracane żadne dane. Prawidłowe wartości to:

  • adresy
  • ageRanges
  • biografie
  • urodziny
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • wydarzenia
  • externalIds
  • płeć
  • imClients
  • zainteresowania
  • locales
  • lokalizacje
  • kanału
  • metadane
  • miscKeywords
  • names
  • pseudonimy
  • zawody
  • organizations
  • phoneNumbers
  • fotografie
  • relacje
  • sipAddresses
  • umiejętności
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Opcjonalnie. Maska typów źródeł do zwrócenia w odczytu po zmianie. Jeśli nie zostanie ustawiony, domyślna wartość to READ_SOURCE_TYPE_CONTACT i READ_SOURCE_TYPE_PROFILE.

Treść odpowiedzi

Jeśli operacja się nie powiodła, funkcja zwraca wartość BatchCreateContactsErrorDetails, która zawiera listę błędów związanych z każdym nieprawidłowym kontaktem.

Odpowiedź na żądanie utworzenia grupy kontaktów.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Pola
createdPeople[]

object (PersonResponse)

Utworzono kontakty, chyba że żądanie readMask jest puste.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.

ContactToCreate

Kod zawierający dane osoby, które mają służyć do wypełniania nowo utworzonego źródła.

Zapis JSON 
{
  "contactPerson": {
    object (Person)
  }
}
Pola
contactPerson

object (Person)

To pole jest wymagane. Dane dotyczące osób, które mają zostać uzupełnione w nowo utworzonym źródle.