Zarządzanie przedstawicielami kontaktów

W tym przewodniku znajdziesz informacje o tym, jak tworzyć, wyświetlać i usuwać przedstawicieli kontaktów użytkowników Google Workspace.

Użytkownicy Google Workspace mogą zezwolić innym użytkownikom w domenie na dostęp do swoich kontaktów i zarządzanie nimi. Tacy przedstawiciele mogą dodawać i aktualizować informacje w Twoich kontaktach – na przykład imiona i nazwiska, numery telefonów czy adresy.

Ten przewodnik dotyczy przekazywania dostępu do kontaktów. Aby przekazać dostęp do Gmaila, przeczytaj artykuł Przekazywanie dostępu do konta e-mail i korzystanie z niego do współpracy.

Wymagania wstępne

Zanim zaczniesz korzystać z interfejsu Contact Delegation API, musisz spełnić te wymagania:

  • Włącz udostępnianie kontaktów: administrator katalogu musi włączyć udostępnianie kontaktów w konsoli administracyjnej. Więcej informacji znajdziesz w artykule Włączanie i wyłączanie udostępniania kontaktów.
  • Uprawnienia administratora: aby zarządzać przedstawicielami innych użytkowników, musisz mieć uprawnienia administratora „Kontakty”.
  • Ograniczenie domeny: możesz przekazywać kontakty tylko użytkownikom w tej samej organizacji Google Workspace.
  • Zakres protokołu OAuth: Twoja aplikacja musi używać tego zakresu protokołu OAuth:https://www.googleapis.com/auth/admin.contact.delegation

Utwórz przedstawiciela

Aby utworzyć przedstawiciela dla użytkownika, wyślij żądanie POST z adresem e-mail delegującego:

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Zastąp USER_EMAIL adresem e-mail delegującego.

W treści żądania podaj adres e-mail osoby, której chcesz przyznać dostęp:

{
  "email": "DELEGATE_EMAIL"
}

Zastąp DELEGATE_EMAIL adresem e-mail przedstawiciela.

Pomyślna odpowiedź zwraca kod stanu HTTP 200 i adres e-mail nowego pełnomocnika:

{
  "email": "DELEGATE_EMAIL"
}

Wyświetlanie listy delegatów

Aby wyświetlić listę pełnomocników kontaktów użytkownika, wyślij żądanie GET z adresem e-mail tego użytkownika:

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Zastąp USER_EMAIL adresem e-mail użytkownika.

Odpowiedź zakończona powodzeniem zwraca kod stanu HTTP 200 i listę adresów e-mail przedstawicieli:

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

Usuwanie przedstawiciela

Aby usunąć przedstawiciela z kontaktów użytkownika, wykonaj te czynności:

  1. Wskaż przedstawiciela do usunięcia. Aby znaleźć adres e-mail konkretnego pełnomocnika, użyj metody List delegates (Wyświetl pełnomocników).

  2. Wyślij żądanie DELETE z adresami e-mail osoby delegującej i przedstawiciela:

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL

Zastąp USER_EMAIL adresem e-mail osoby, która przekazuje dostęp, a DELEGATE_EMAIL adresem e-mail osoby, która otrzymuje dostęp.

Odpowiedź zakończona powodzeniem zwraca kod stanu HTTP 200.