Method: people.batchUpdateContacts

Aktualisieren Sie einen Batch von Kontakten und geben Sie eine Zuordnung der Ressourcennamen an PersonResponses für die aktualisierten Kontakte zurück.

Mutate-Anfragen für denselben Nutzer sollten nacheinander gesendet werden, um erhöhte Latenz und Fehler zu vermeiden.

HTTP-Anfrage

POST https://people.googleapis.com/v1/people:batchUpdateContacts

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "contacts": {
    string: {
      object (Person)
    },
    ...
  },
  "updateMask": string,
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Felder
contacts

map (key: string, value: object (Person))

Erforderlich. Eine Zuordnung von Ressourcennamen zu den zu aktualisierenden Personendaten. Bis zu 200 Kontakte in einer Anfrage.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
updateMask

string (FieldMask format)

Erforderlich. Eine Feldmaske, mit der eingeschränkt wird, welche Felder der Person aktualisiert werden. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Alle angegebenen Felder werden ersetzt oder gelöscht, wenn das Feld für jede Person leer bleibt. Gültige Werte sind:

  • addresses
  • Biografien
  • Geburtstage
  • calendarUrls
  • Kundendaten
  • emailAddresses
  • Veranstaltungen
  • Externe IDs
  • geschlechter
  • Kunden
  • interessen
  • locales
  • Standorte
  • mitgliedschaft
  • Sonstige Keywords
  • names
  • Spitznamen
  • Berufe
  • organizations
  • phoneNumbers
  • Beziehungen
  • sipAdressen
  • URLs
  • Benutzerdefiniert
readMask

string (FieldMask format)

Erforderlich. Eine Feldmaske zur Einschränkung der zurückgegebenen Felder für jede Person. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Wenn die Lesemaske leer gelassen wird, wird die Methode nach der Mutation übersprungen und es werden keine Daten in der Antwort zurückgegeben. Gültige Werte sind:

  • addresses
  • Altersbereiche
  • Biografien
  • Geburtstage
  • calendarUrls
  • Kundendaten
  • Cover Photos
  • emailAddresses
  • Veranstaltungen
  • Externe IDs
  • geschlechter
  • Kunden
  • interessen
  • locales
  • Standorte
  • mitgliedschaft
  • metadata
  • Sonstige Keywords
  • names
  • Spitznamen
  • Berufe
  • organizations
  • phoneNumbers
  • fotos
  • Beziehungen
  • sipAdressen
  • skills
  • URLs
  • Benutzerdefiniert
sources[]

enum (ReadSourceType)

Optional. Eine Maske, welche Quelltypen zurückgegeben werden sollen. Wenn kein Wert festgelegt ist, werden standardmäßig READ_SOURCE_TYPE_CONTACT und READ_SOURCE_TYPE_PROFILE verwendet.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Wenn der Vorgang nicht erfolgreich war, wird BatchUpdateContactsErrorDetails zurückgegeben, eine Liste der Fehler für jeden Kontakt.

Die Antwort auf eine Anfrage zum Aktualisieren eines Batches von Kontakten.

JSON-Darstellung 
{
  "updateResult": {
    string: {
      object (PersonResponse)
    },
    ...
  }
}
Felder
updateResult

map (key: string, value: object (PersonResponse))

Eine Zuordnung von Ressourcennamen zu den aktualisierten Kontakten, sofern die Anfrage readMask leer ist.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.