REST Resource: people

{
  "sources": [
    {
      object (Source)
    }
  ],
  "previousResourceNames": [
    string
  ],
  "linkedPeopleResourceNames": [
    string
  ],
  "deleted": boolean,
  "objectType": enum (ObjectType)
}

object (Source)

Źródła danych dotyczących danej osoby.

string

Tylko dane wyjściowe. Wszystkie wcześniejsze nazwy zasobów, które ta osoba miała. Wartość wypełniana tylko w przypadku people.connections.list żądań zawierających token synchronizacji.

Nazwa zasobu może się zmienić podczas dodawania lub usuwania pól, które łączą kontakt i profil, takich jak zweryfikowany adres e-mail, zweryfikowany numer telefonu lub URL profilu.

string

Tylko dane wyjściowe. Nazwy zasobów osób połączonych z tym zasobem.

boolean

Tylko dane wyjściowe. Wartość „prawda”, jeśli zasób osoby został usunięty. Wartość podawana tylko w przypadku żądań synchronizacji people.connections.list i otherContacts.list.

enum (ObjectType)

Tylko dane wyjściowe. WYCOFANO (zamiast tego użyj person.metadata.sources.profileMetadata.objectType)

Typ obiektu osoby.

{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,
  "profileMetadata": {
    object (ProfileMetadata)
  }
}

enum (SourceType)

Typ źródła.

string

Unikalny identyfikator typu źródła wygenerowany przez serwer.

string

Wypełnianie tylko w języku: person.metadata.sources.

Tag jednostki HTTP źródła. Służy do sprawdzania poprawności pamięci podręcznej.

string (Timestamp format)

Tylko dane wyjściowe. Wypełnianie tylko w języku: person.metadata.sources.

Sygnatura czasowa ostatniej aktualizacji tego źródła.

Sygnatura czasowa w formacie „Zulu” UTC3339, z rozdzielczością nanosekundą i maksymalnie 9 cyframi. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (ProfileMetadata)

Tylko dane wyjściowe. Wypełnianie tylko w języku: person.metadata.sources.

Metadane dotyczące źródła typu PROFILE.

{
  "objectType": enum (ObjectType),
  "userTypes": [
    enum (UserType)
  ]
}

enum (ObjectType)

Tylko dane wyjściowe. Typ obiektu profilu.

enum (UserType)

Tylko dane wyjściowe. Typy użytkowników.

{
  "metadata": {
    object (FieldMetadata)
  },
  "formattedValue": string,
  "type": string,
  "formattedType": string,
  "poBox": string,
  "streetAddress": string,
  "extendedAddress": string,
  "city": string,
  "region": string,
  "postalCode": string,
  "country": string,
  "countryCode": string
}

object (FieldMetadata)

Metadane dotyczące adresu.

string

Nieustrukturyzowana wartość adresu. Jeśli tego nie zrobisz, element zostanie utworzony automatycznie na podstawie wartości strukturalnych.

string

Typ adresu. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• home
• work
• other

string

Tylko dane wyjściowe. Typ adresu przetłumaczonego i sformatowanego w języku regionalnym konta użytkownika lub w nagłówku HTTP Accept-Language.

string

Skrytka pocztowa adresu.

string

Ulica i numer.

string

Dłuższy adres, np. numer mieszkania.

string

Miasto adresu.

string

Region adresu, na przykład województwo lub region.

string

Kod pocztowy adresu.

string

Kraj adresu.

string

Kod kraju w formacie ISO 3166-1 alfa-2.

{
  "primary": boolean,
  "sourcePrimary": boolean,
  "verified": boolean,
  "source": {
    object (Source)
  }
}

boolean

Tylko dane wyjściowe. Wartość to „prawda”, jeśli to pole jest podstawowym polem dla wszystkich źródeł w danej osobie. W przypadku każdej osoby pole primary ma wartość „true” (prawda).

boolean

Wartość to „prawda”, jeśli to pole jest podstawowe w przypadku pola source. Każde źródło może mieć co najmniej jedno pole z wartością sourcePrimary ustawioną na „true”.

boolean

Tylko dane wyjściowe. Wartość „prawda”, jeśli pole jest zweryfikowane, „fałsz”, jeśli pole jest niezweryfikowane. Zwykle chodzi o imię i nazwisko, adres e-mail, numer telefonu lub witrynę, której własność została potwierdzona.

object (Source)

Źródło pola.

{
  "metadata": {
    object (FieldMetadata)
  },
  "ageRange": enum (AgeRange)
}

object (FieldMetadata)

Metadane dotyczące przedziału wiekowego.

enum (AgeRange)

Przedział wiekowy.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "contentType": enum (ContentType)
}

object (FieldMetadata)

Metadane biografii.

string

Krótka biografia.

enum (ContentType)

Typ treści biografii.

{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "text": string
}

object (FieldMetadata)

Metadane dotyczące urodzin.

object (Date)

Uporządkowana data urodzenia.

string

Wolisz korzystać z pola date, jeśli jest ustawione.

Dowolny ciąg znaków reprezentujący urodziny użytkownika. Ta wartość nie jest zweryfikowana.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Rok daty. Do określenia daty bez roku musi mieścić się w zakresie 1–9999 lub 0.

integer

Miesiąc roku. Należy podać wartość od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia.

integer

Dzień miesiąca. Wartość musi mieścić się w przedziale od 1 do 31 i być ważna dla roku i miesiąca lub 0 w celu wybrania roku lub samego miesiąca i miesiąca, w którym dzień nie jest istotny.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadane na temat tego, czym się chwala.

string

Tym mogę się pochwalić, np. climbed mount everest.

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadane adresu URL kalendarza.

string

Adres URL kalendarza.

string

Typ adresu URL kalendarza. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• home
• freeBusy
• work

string

Tylko dane wyjściowe. Typ adresu URL kalendarza przetłumaczony i sformatowany w ustawieniach regionalnych konta użytkownika lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}

object (FieldMetadata)

Metadane dotyczące danych klienta.

string

Klucz klienta określony przez klienta.

string

Określona przez klienta wartość danych klienta.

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}

object (FieldMetadata)

Metadane dotyczące zdjęcia na okładkę.

string

Adres URL zdjęcia na okładkę.

boolean

Wartość „prawda”, jeśli zdjęcie na okładkę jest domyślnym zdjęciem na okładkę; „fałsz”, jeśli zdjęcie na okładkę to zdjęcie na okładkę dostarczone przez użytkownika.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string,
  "displayName": string
}

object (FieldMetadata)

Metadane dotyczące adresu e-mail.

string

Adres e-mail.

string

Typ adresu e-mail. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• home
• work
• other

string

Tylko dane wyjściowe. Typ adresu e-mail przetłumaczony i sformatowany w ustawieniach regionalnych konta przeglądającego lub w nagłówku HTTP Accept-Language.

string

Wyświetlana nazwa e-maila.

{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadane zdarzenia.

object (Date)

Data wydarzenia.

string

Typ zdarzenia. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• anniversary
• other

string

Tylko dane wyjściowe. Typ zdarzenia przetłumaczony i sformatowany w ustawieniach regionalnych konta użytkownika lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadane dotyczące identyfikatora zewnętrznego.

string

Wartość zewnętrznego identyfikatora.

string

Typ identyfikatora zewnętrznego. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• account
• customer
• loginId
• network
• organization

string

Tylko dane wyjściowe. Typ zdarzenia przetłumaczony i sformatowany w ustawieniach regionalnych konta użytkownika lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadane dotyczące pliku.

string

Wartość pliku jako

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string,
  "addressMeAs": string
}

object (FieldMetadata)

Metadane dotyczące płci.

string

Płeć danej osoby. Płeć może być niestandardowa lub jedna z tych wstępnie zdefiniowanych wartości:

• male
• female
• unspecified

string

Tylko dane wyjściowe. Wartość płci przetłumaczonej i sformatowana w regionie konta użytkownika lub w nagłówku HTTP Accept-Language. Nieokreślone lub niestandardowe wartości nie są zlokalizowane.

string

Pole tekstowe na zaimki, które powinno być używane do zwracania się do osoby. Typowe wartości:

• he/him
• she/her
• they/them

{
  "metadata": {
    object (FieldMetadata)
  },
  "username": string,
  "type": string,
  "formattedType": string,
  "protocol": string,
  "formattedProtocol": string
}

object (FieldMetadata)

Metadane dotyczące klienta czatu.

string

Nazwa użytkownika używana w kliencie czatu.

string

Typ klienta czatu. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• home
• work
• other

string

Tylko dane wyjściowe. Typ klienta komunikatora przetłumaczony i sformatowany w ustawieniach regionalnych konta przeglądającego lub w nagłówku HTTP Accept-Language.

string

Protokół klienta czatu. Protokół może być niestandardowy lub jedną z tych wstępnie zdefiniowanych wartości:

• aim
• msn
• yahoo
• skype
• qq
• googleTalk
• icq
• jabber
• netMeeting

string

Tylko dane wyjściowe. Protokół klienta czatu w formacie regionalnym konta użytkownika lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadane dotyczące zainteresowania.

string

Zainteresowanie, np. stargazing.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadane dotyczące ustawień regionalnych.

string

Prawidłowo sformułowany tag języka IETF BCP 47 reprezentujący język.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "current": boolean,
  "buildingId": string,
  "floor": string,
  "floorSection": string,
  "deskCode": string
}

object (FieldMetadata)

Metadane dotyczące lokalizacji.

string

Swobodna wartość lokalizacji.

string

Typ lokalizacji. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• desk
• grewUp

boolean

Określa, czy jest to bieżąca lokalizacja.

string

Identyfikator budynku.

string

Nazwa lub numer piętra.

string

Obszar piętra: floor_name.

string

lokalizacja pojedynczego biurka,

{
  "metadata": {
    object (FieldMetadata)
  },

  // Union field membership can be only one of the following:
  "contactGroupMembership": {
    object (ContactGroupMembership)
  },
  "domainMembership": {
    object (DomainMembership)
  }
  // End of list of possible types for union field membership.
}

object (FieldMetadata)

Metadane dotyczące subskrypcji.

object (ContactGroupMembership)

Przynależność do grupy kontaktów.

object (DomainMembership)

Tylko dane wyjściowe. Przynależność do domeny.

{
  "contactGroupId": string,
  "contactGroupResourceName": string
}

string

Tylko dane wyjściowe. Identyfikator grupy kontaktów związanej z członkostwem w grupie kontaktów.

string

Nazwa zasobu grupy kontaktów przypisana przez serwer. Ciąg ASCII w formacie contactGroups/{contactGroupId}. Do modyfikowania członkostwa można używać tylko contactGroupResourceName. Członkostwo w grupach kontaktów można usunąć, ale można dodać tylko grupy użytkowników, grupy systemowe „moje kontakty” lub „gwiazdki”. Kontakt musi mieć co najmniej 1 członkostwo w grupie kontaktów.

{
  "inViewerDomain": boolean
}

boolean

Prawda, jeśli osoba znajduje się w domenie Google Workspace użytkownika.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (KeywordType),
  "formattedType": string
}

object (FieldMetadata)

Metadane o innym słowie kluczowym.

string

Wartość innego słowa kluczowego.

enum (KeywordType)

Inne typy słów kluczowych.

string

Tylko dane wyjściowe. Typ innego słowa kluczowego przetłumaczonego i sformatowanego w regionie konta użytkownika lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "displayName": string,
  "displayNameLastFirst": string,
  "unstructuredName": string,
  "familyName": string,
  "givenName": string,
  "middleName": string,
  "honorificPrefix": string,
  "honorificSuffix": string,
  "phoneticFullName": string,
  "phoneticFamilyName": string,
  "phoneticGivenName": string,
  "phoneticMiddleName": string,
  "phoneticHonorificPrefix": string,
  "phoneticHonorificSuffix": string
}

object (FieldMetadata)

Metadane dotyczące nazwy.

string

Tylko dane wyjściowe. Wyświetlana nazwa powinna być sformatowana zgodnie z językiem określonym na koncie osoby przeglądającej lub w nagłówku HTTP Accept-Language.

string

Tylko dane wyjściowe. Wyświetlana nazwa musi mieć format najpierw zgodny z językiem ustawionym na koncie osoby przeglądającej lub w nagłówku HTTP Accept-Language.

string

Wartość nazwy swobodnej.

string

Nazwisko.

string

Imię.

string

Drugie imię.

string

honorowe prefiksy, np. Mrs. lub Dr..

string

Imponujące sufiksy, na przykład Jr.

string

Imię i nazwisko zapisane na głos.

string

Nazwisko zapisane na głos.

string

Imię zostało zapisane na głos.

string

Drugie imię zapisane na głos.

string

Imponujące prefiksy zapisane z dźwiękiem.

string

Wyrazy poprawnie brzmiące.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (NicknameType)
}

object (FieldMetadata)

Metadane dotyczące pseudonimu.

string

Pseudonim.

enum (NicknameType)

Typ pseudonimu.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadane zawodu.

string

Zawód, na przykład carpenter.

{
  "metadata": {
    object (FieldMetadata)
  },
  "type": string,
  "formattedType": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "current": boolean,
  "name": string,
  "phoneticName": string,
  "department": string,
  "title": string,
  "jobDescription": string,
  "symbol": string,
  "domain": string,
  "location": string,
  "costCenter": string,
  "fullTimeEquivalentMillipercent": integer
}

object (FieldMetadata)

Metadane organizacji.

string

Typ organizacji. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• work
• school

string

Tylko dane wyjściowe. Typ organizacji przetłumaczony i sformatowany w ustawieniach regionalnych konta użytkownika lub w nagłówku HTTP Accept-Language.

object (Date)

Data rozpoczęcia dołączania przez użytkownika do organizacji.

object (Date)

Dzień, w którym użytkownik opuścił organizację.

boolean

Wartość „prawda”, jeśli organizacja jest obecną organizacją danej osoby, „fałsz”, jeśli organizacja jest już w przeszłości.

string

Nazwa organizacji.

string

Fonetyczna nazwa organizacji.

string

Dział osoby w organizacji.

string

Stanowisko danej osoby w organizacji.

string

Opis stanowiska pracy w organizacji.

string

Symbol powiązany z organizacją, na przykład symbol giełdowy, skrót lub akronim.

string

Nazwa domeny powiązana z organizacją, na przykład google.com.

string

Lokalizacja biura organizacji, w którym pracuje dana osoba.

string

Centrum kosztów danej osoby w organizacji.

integer

Równoważnik pełnoetatowy danej osoby w organizacji (100 000 = 100%).

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "canonicalForm": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadane dotyczące numeru telefonu.

string

Numer telefonu.

string

Tylko dane wyjściowe. Wersja kanoniczna numeru telefonu ITU-T E.164.

string

Typ numeru telefonu. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• home
• work
• mobile
• homeFax
• workFax
• otherFax
• pager
• workMobile
• workPager
• main
• googleVoice
• other

string

Tylko dane wyjściowe. Typ numeru telefonu przetłumaczony i sformatowany w ustawieniach języka konta przeglądającego lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}

object (FieldMetadata)

Metadane zdjęcia.

string

Adres URL zdjęcia. Możesz zmienić wybrany rozmiar, dodając parametr zapytania sz={size} na końcu adresu URL, gdzie {size} to rozmiar w pikselach. Przykład: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50

boolean

Prawda, jeśli zdjęcie jest domyślne, lub fałsz, jeśli jest to zdjęcie przekazane przez użytkownika.

{
  "metadata": {
    object (FieldMetadata)
  },
  "person": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadane relacji.

string

Imię i nazwisko osoby, do której odnosi się ten związek.

string

Relacja tej osoby z drugą osobą. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• spouse
• child
• mother
• father
• parent
• brother
• sister
• friend
• relative
• domesticPartner
• manager
• assistant
• referredBy
• partner

string

Tylko dane wyjściowe. Typ relacji przetłumaczony i sformatowany w języku konta użytkownika lub regionie podanym w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}

object (FieldMetadata)

Metadane dotyczące zainteresowania relacją.

string

Typ relacji, której szuka osoba. Wartością może być niestandardowa lub jedna z tych wstępnie zdefiniowanych wartości:

• friend
• date
• relationship
• networking

string

Tylko dane wyjściowe. Wartość zainteresowania relacją przetłumaczona i sformatowana w języku konta użytkownika lub w języku określonym w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}

object (FieldMetadata)

Metadane dotyczące stanu relacji.

string

Związki. Wartością może być niestandardowa lub jedna z tych wstępnie zdefiniowanych wartości:

• single
• inARelationship
• engaged
• married
• itsComplicated
• openRelationship
• widowed
• inDomesticPartnership
• inCivilUnion

string

Tylko dane wyjściowe. Wartość stanu relacji została przetłumaczona i sformatowana w regionie konta użytkownika lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "current": boolean
}

object (FieldMetadata)

Metadane dotyczące miejsca zamieszkania.

string

Adres zamieszkania.

boolean

Wartość to „prawda”, jeśli miejsce zamieszkania to aktualne miejsce zamieszkania danej osoby.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadane dotyczące adresu SIP.

string

Adres SIP w formacie RFC 3261 19.1 identyfikatora URI SIP.

string

Typ adresu SIP. Może to być wartość niestandardowa lub jedna z tych wstępnie zdefiniowanych wartości:

• home
• work
• mobile
• other

string

Tylko dane wyjściowe. Typ adresu SIP przetłumaczony i sformatowany w ustawieniach regionalnych konta użytkownika lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadane dotyczące umiejętności.

string

Umiejętność, na przykład underwater basket weaving.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadane dotyczące sloganu.

string

Opis.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadane adresu URL.

string

Adres URL.

string

Typ adresu URL. Typ może być niestandardowy lub jedna z tych wstępnie zdefiniowanych wartości:

• home
• work
• blog
• profile
• homePage
• ftp
• reservations
• appInstallPage: witryna aplikacji Currents.
• other

string

Tylko dane wyjściowe. Typ adresu URL przetłumaczony i sformatowany w ustawieniach regionalnych konta użytkownika lub w nagłówku HTTP Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}

object (FieldMetadata)

Metadane dotyczące danych zdefiniowanych przez użytkownika.

string

Klucz określony przez użytkownika dla danych zdefiniowanych przez użytkownika.

string

Wartość użytkownika określona przez użytkownika.