REST Resource: people

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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

object (Source)

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

string

Tylko dane wyjściowe. Wszelkie poprzednie nazwy zasobów, które ta osoba używała. Wartość podawana tylko w przypadku żądań people.connections.list zawierających token synchronizacji.

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

string

Tylko dane wyjściowe. Nazwy zasobów osób powiązanych z tym zasobem.

boolean

Tylko dane wyjściowe. 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. WYCOFANY (zamiast niego użyj person.metadata.sources.profileMetadata.objectType)

Typ obiektu osoby.

{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,

  // Union field metadata can be only one of the following:
  "profileMetadata": {
    object (ProfileMetadata)
  }
  // End of list of possible types for union field metadata.
}

enum (SourceType)

Typ źródła.

string

Unikalny identyfikator w ramach typu źródła wygenerowanego przez serwer.

string

Podawane tylko w person.metadata.sources.

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

string (Timestamp format)

Tylko dane wyjściowe. Podawane tylko w person.metadata.sources.

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

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (ProfileMetadata)

Tylko dane wyjściowe. Podawane tylko w 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. Pismo wpisywane przez użytkownika.

{
  "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 użytkownik nie ustawi tej wartości, zostanie on automatycznie utworzony na podstawie uporządkowanych wartości.

string

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

• home
• work
• other

string

Tylko dane wyjściowe. Typ przetłumaczonego i sformatowanego adresu zgodnie z ustawieniami języka konta przeglądającego lub w języku nagłówka HTTP Accept-Language.

string

Pocztówki w polu adresu.

string

Ulica i numer.

string

rozszerzony adres, na przykład numer mieszkania.

string

Miasto w adresie.

string

region adresu; na przykład region.

string

Kod pocztowy w adresie.

string

Kraj w adresie.

string

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

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

boolean

Tylko dane wyjściowe. Prawda, jeśli pole jest polem głównym dla wszystkich źródeł w danej osobie. Każda osoba może mieć maksymalnie 1 pole z wartością primary ustawioną na true.

boolean

Prawda, jeśli pole jest głównym polem funkcji source. Każde źródło może mieć maksymalnie 1 pole z wartością sourcePrimary ustawioną na true.

boolean

Tylko dane wyjściowe. Prawda, jeśli pole jest zweryfikowane; Wartość false, jeśli pole nie jest zweryfikowane. Pole zweryfikowane to zazwyczaj imię i nazwisko, adres e-mail, numer telefonu lub adres strony, co do których mamy potwierdzenie, że dana osoba należy do danej osoby.

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 dotyczące biografii

string

Krótka biografia

enum (ContentType)

Rodzaj treści biografii.

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

object (FieldMetadata)

Metadane dotyczące urodzin.

object (Date)

Uporządkowana data urodzin.

string

Wolę używać pola date, jeśli jest ustawione.

Swobodny ciąg znaków reprezentujący datę urodzenia użytkownika. Ta wartość nie została zweryfikowana.

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

integer

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

integer

Miesiąc w roku. Musi mieścić się w zakresie od 1 do 12 lub 0, jeśli chcesz określić rok bez miesiąca i dnia.

integer

Dzień miesiąca. Wartość musi należeć do zakresu od 1 do 31 i jest ważna dla roku i miesiąca. Wartość 0 pozwala określić pojedynczy rok lub rok i miesiąc, w którym dzień nie jest istotny.

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

object (FieldMetadata)

Metadane dotyczące Tym, czym chcesz się pochwalić.

string

Tym mogę się pochwalić. na przykład climbed mount everest.

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

object (FieldMetadata)

Metadane dotyczące adresu URL kalendarza.

string

Adres URL kalendarza.

string

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

• home
• freeBusy
• work

string

Tylko dane wyjściowe. Typ przetłumaczonego i sformatowanego adresu URL kalendarza zgodnie z ustawieniami regionalnymi konta osoby przeglądającej lub językiem nagłówka HTTP Accept-Language.

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

object (FieldMetadata)

Metadane dotyczące danych klienta.

string

Klient określił klucz danych klienta.

string

Określona przez klienta wartość danych klienta.

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

object (FieldMetadata)

Metadane zdjęcia na okładkę.

string

Adres URL zdjęcia na okładkę.

boolean

Prawda, jeśli zdjęcie na okładkę jest domyślnym zdjęciem na okładkę; false, jeśli zdjęcie na okładkę jest zdjęciem na okładkę przesłanym 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. Może to być wartość niestandardowa lub jedna z tych wartości zdefiniowanych wstępnie:

• home
• work
• other

string

Tylko dane wyjściowe. Typ adresu e-mail przetłumaczonego i sformatowanego zgodnie z ustawieniami języka konta przeglądającego lub w języku nagłówka HTTP Accept-Language.

string

Wyświetlana nazwa e-maila.

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

object (FieldMetadata)

Metadane dotyczące wydarzenia.

object (Date)

Data zdarzenia.

string

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

• anniversary
• other

string

Tylko dane wyjściowe. Typ zdarzenia przetłumaczonego i sformatowanego zgodnie z językiem konta wyświetlającego lub język nagłówka HTTP Accept-Language.

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

object (FieldMetadata)

Metadane dotyczące identyfikatora zewnętrznego.

string

Wartość identyfikatora zewnętrznego.

string

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

• account
• customer
• loginId
• network
• organization

string

Tylko dane wyjściowe. Typ zdarzenia przetłumaczonego i sformatowanego zgodnie z językiem konta wyświetlającego lub język nagłówka HTTP Accept-Language.

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

object (FieldMetadata)

Metadane dotyczące pliku jako.

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ć wartością niestandardową lub jedną z tych wstępnie zdefiniowanych wartości:

• male
• female
• unspecified

string

Tylko dane wyjściowe. Wartość płci przetłumaczonej i sformatowanej zgodnie z ustawieniami języka konta przeglądającego lub w języku nagłówka HTTP Accept-Language. Wartości nieokreślone lub niestandardowe nie są lokalizowane.

string

Pole tekstowe do wpisania zaimków, które mają być używane do zwracania się do osoby. Typowe wartości to:

• 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 komunikatora

string

Nazwa użytkownika używana w kliencie czatu.

string

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

• home
• work
• other

string

Tylko dane wyjściowe. Typ klienta komunikatora przetłumaczonego i sformatowanego zgodnie z językiem konta przeglądającego lub język nagłówka HTTP Accept-Language.

string

Protokół klienta komunikatora. 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 komunikatora sformatowany zgodnie z językiem konta wyświetlającego lub język nagłówka HTTP Accept-Language.

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

object (FieldMetadata)

Metadane dotyczące zainteresowania.

string

Zainteresowanie; na przykład stargazing.

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

object (FieldMetadata)

Metadane dotyczące regionu.

string

Prawidłowo sformatowany tag języka IETF BCP 47 reprezentujący region.

{
  "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. Może to być wartość niestandardowa lub jedna z tych wartości zdefiniowanych wstępnie:

• desk
• grewUp

boolean

Określa, czy lokalizacja jest bieżącą lokalizacją.

string

Identyfikator budynku.

string

Nazwa lub numer piętra.

string

Obszar piętra w: 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. Subskrypcja domeny.

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

string

Tylko dane wyjściowe. Identyfikator grupy kontaktów na potrzeby członkostwa 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. Można usunąć każde członkostwo w grupie kontaktów, ale tylko grupa użytkowników lub „myContacts” lub „oznaczone gwiazdką” Członkostwa w grupach systemowych. Kontakt musi zawsze należeć do co najmniej jednej grupy kontaktów.

{
  "inViewerDomain": boolean
}

boolean

Wartość to „prawda”, jeśli osoba jest w domenie Google Workspace widza.

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

object (FieldMetadata)

Metadane dotyczące różnych słów kluczowych.

string

Wartość innego słowa kluczowego.

enum (KeywordType)

Różne typy słów kluczowych.

string

Tylko dane wyjściowe. Rodzaj przetłumaczonego i sformatowanego słowa kluczowego określonego na koncie użytkownika wyświetlającego lub w języku nagłówka 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 nazwy.

string

Tylko dane wyjściowe. Wyświetlana nazwa sformatowana zgodnie z językiem określonym przez konto przeglądającego lub w nagłówku HTTP Accept-Language.

string

Tylko dane wyjściowe. Wyświetlana nazwa z nazwiskiem sformatowana najpierw zgodnie z językiem określonym przez konto przeglądającego lub w nagłówku HTTP Accept-Language.

string

Wartość nazwy eksploracji swobodnej.

string

Nazwisko.

string

Podane imię.

string

Drugie imię.

string

Prefiksy honorowe, takie jak Mrs. lub Dr.

string

sufiksy honorowe, na przykład Jr.;

string

Pełne imię i nazwisko zapisane w sposób, w jaki może brzmieć.

string

Nazwisko zapisane zgodnie z jej brzmieniem.

string

Imię zapisane tak, jak się wymawia.

string

Drugie imię zapisane zgodnie z ich brzmieniem.

string

Honorowe prefiksy napisane w taki sposób, w jaki się wymawia.

string

Sufiksy honorowe zapisywane w taki sposób, w jaki się wymawia.

{
  "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 dotyczące zatrudnienia.

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 dotyczące organizacji.

string

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

• work
• school

string

Tylko dane wyjściowe. Typ organizacji przetłumaczony i sformatowany zgodnie z ustawieniami języka konta przeglądającego lub w języku nagłówka HTTP Accept-Language.

object (Date)

Data rozpoczęcia, kiedy dana osoba dołączyła do organizacji.

object (Date)

Data zakończenia, kiedy dana osoba opuściła organizację.

boolean

Wartość to „prawda”, jeśli organizacja jest bieżącą organizacją danej osoby. Wartość false, jeśli organizacja należy do przeszłości.

string

Nazwa organizacji.

string

Fonetyczna nazwa organizacji.

string

Dział osoby w organizacji.

string

Stanowisko tej osoby w organizacji.

string

Opis stanowiska osoby w organizacji.

string

symbol powiązany z organizacją; na przykład symbol spółki giełdowej, skrót lub akronim.

string

nazwa domeny powiązana z organizacją; na przykład google.com.

string

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

string

Centrum kosztów danej osoby w organizacji.

integer

Równowartość pełnoetatowa 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. Kanoniczna postać numeru telefonu ITU-T E.164.

string

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

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

string

Tylko dane wyjściowe. Typ przetłumaczonego i sformatowanego numeru telefonu zgodnie z językiem konta użytkownika lub językiem nagłówka HTTP Accept-Language.

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

object (FieldMetadata)

Metadane zdjęcia.

string

Adres URL zdjęcia. Możesz zmienić żądany rozmiar, dodając na końcu adresu URL parametr zapytania sz={size}, 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 zdjęciem domyślnym; false, jeśli zdjęcie zostało udostępnione przez użytkownika.

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

object (FieldMetadata)

Metadane dotyczące relacji.

string

Imię i nazwisko drugiej osoby, do której odnosi się to powiązanie.

string

Związek danej osoby z drugą osobą. Może to być wartość niestandardowa lub jedna z tych wartości zdefiniowanych wstępnie:

• 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 na podstawie ustawień regionalnych konta użytkownika lub regionu określonego w nagłówku HTTP Accept-Language.

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

object (FieldMetadata)

Metadane dotyczące zainteresowania relacjami.

string

Rodzaj relacji szukanej przez daną osobę. Może to być wartość niestandardowa lub jedna z tych wstępnie zdefiniowanych wartości:

• friend
• date
• relationship
• networking

string

Tylko dane wyjściowe. Wartość relacji zainteresowania została przetłumaczona i sformatowana zgodnie z ustawieniami regionalnymi konta użytkownika lub językiem 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. Może to być wartość 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 na język konta wyświetlającego lub na język nagłówka HTTP Accept-Language.

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

object (FieldMetadata)

Metadane dotyczące miejsca zamieszkania.

string

Adres miejsca zamieszkania.

boolean

„prawda”, jeśli miejsce zamieszkania jest aktualnym miejscem zamieszkania danej osoby; Wartość false, jeśli miejsce zamieszkania to wcześniejsze mieszkanie.

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

object (FieldMetadata)

Metadane dotyczące adresu SIP.

string

Adres SIP w formacie identyfikatora SIP URI RFC 3261 19.1.

string

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

• home
• work
• mobile
• other

string

Tylko dane wyjściowe. Typ adresu SIP przetłumaczonego i sformatowanego zgodnie z ustawieniami języka konta przeglądającego lub dla regionu nagłówka 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

Slogan.

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

object (FieldMetadata)

Metadane dotyczące adresu URL.

string

Adres URL.

string

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

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

string

Tylko dane wyjściowe. Typ przetłumaczonego i sformatowanego adresu URL zgodnie z ustawieniami języka konta przeglądającego lub w języku nagłówka HTTP Accept-Language.

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

object (FieldMetadata)

Metadane dotyczące danych zdefiniowanych przez użytkownika.

string

Określony przez użytkownika klucz danych zdefiniowanych przez użytkownika.

string

Określona przez użytkownika wartość danych zdefiniowanych przez użytkownika.