Alandan üye çıkarma

Bu kılavuzda, delete() yöntemini kaldırmak için Google Chat API'nin Membership kaynağında alan, üyelik silme olarak da bilinir. Alandaki tek alan yöneticisi kaldırılamaz. Başka bir kullanıcıyı alan olarak ata yönetici ile iletişime geçin.

Google Workspace yöneticisiyseniz kullanıcıları kaldırabilir, Google Gruplar'ı veya kuruluşunuzdaki herhangi bir alandaki Chat Google Workspace kuruluşu.

İlgili içeriği oluşturmak için kullanılan Membership kaynak bir gerçek kullanıcının veya Google Chat uygulamasının davet edilip edilmediğini bir alanın parçası olan ya da olmayan

Ön koşullar

Node.js

  • Google Chat alanı. Google Chat API'yi kullanarak alan oluşturmak için Alan oluşturma başlıklı makaleyi inceleyin. Chat'te hesap oluşturmak için: şurayı ziyaret edin: Yardım Merkezi belgeleri.

Alandan bir üyeyi kullanıcı olarak kaldırma

Kullanıcı kimlik doğrulaması olan bir alandan kullanıcı, Google grubu veya Chat uygulamasını kaldırmak için isteğinizde aşağıdakileri iletin:

  • chat.memberships yetkilendirme kapsamını belirtin. Yetki veren kullanıcının, kullanıcıyı veya Google Grubu'nu kaldırma izni olmalıdır. geri dönelim. Bir Chat uygulamasını kaldırmak için şunu belirtin: chat.memberships.app yetkilendirme kapsamı (uygulamalar yalnızca kendi üyeliğiniz; diğer uygulamalarınkiyle aynı değildir). En iyi uygulama olarak, uygulamanızın çalışmaya devam etmesine izin veren en kısıtlayıcı kapsamı seçin.
  • DeleteMembership() yöntemini çağırın.
  • Silmek istediğiniz üyeliğin name değerini iletin. Üyelik, alandaki tek alan yöneticisine aitse bu üyeliği silmeden önce başka bir kullanıcıyı alan yöneticisi olarak atayın.

Şu adrese giderek üyeliğinizi silebilirsiniz: kullanıcı kimlik doğrulaması:

Node.js

chat/client-libraries/cloud/delete-space-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.delete'];

// This sample shows how to delete a space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'spaces/SPACE_NAME'
  };

  // Make the request
  const response = await chatClient.deleteSpace(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Bu örneği çalıştırmak için aşağıdaki kodu değiştirin:

  • SPACE_NAME: alanın kimliği name Kimliği, ListSpaces() metodunu çağırarak veya alanın URL'sinden alabilirsiniz.
  • MEMBER_NAME: üyenin kimliği name ListMemberships() yöntemini çağırarak kimliği edinebilirsiniz.

Başarılı olursa yanıt gövdesi, 'state': 'NOT_A_MEMBER'. Bu değer, üyenin artık alanda olmadığını gösterir.

{
    "name": "spaces/SPACE_NAME/members/MEMBER_NAME",
    "state": "NOT_A_MEMBER"
}

Alandan bir üyeyi Chat uygulaması olarak çıkarma

Uygulama kimlik doğrulaması bir kerelik gerektirir yönetici onayından yararlanabilir.

Bir kullanıcıyı, Google Grubunu veya Chat uygulamasını şununla yer açın: uygulama kimlik doğrulaması, kart şunları belirtin:

  • chat.app.memberships Yetkilendirme kapsamını belirtin. Alan yöneticisinin üyeliğini silme işlemi yalnızca Chat uygulamaları tarafından oluşturulan alanlarda desteklenir.
  • membership kaynağında delete yöntemini çağırın.
  • Silmek için üyeliğin name öğesini iletin. Üyelik yönetici olarak atadıysanız önce başka bir kullanıcıyı alan yöneticisi bu üyelik siliniyor.

API anahtarı oluşturma

Geliştirici Önizlemesi API yöntemini çağırmak için API keşif belgesinin herkese açık olmayan bir Geliştirici Önizlemesi sürümünü kullanmanız gerekir. İsteğin kimliğini doğrulamak için bir API anahtarı iletmeniz gerekir.

API anahtarını oluşturmak için uygulamanızın Google Cloud projesini açıp aşağıdakileri yapın:

  1. Google Cloud Console'da Menü > API'ler ve Hizmetler > Kimlik bilgileri'ne gidin.

    Kimlik Bilgileri'ne gidin

  2. Kimlik bilgileri oluştur > seçeneğini tıklayın. API anahtarı.
  3. Yeni API anahtarınız gösterilir.
    • Kopyala'yı tıklayın. özelliğini kullanabilirsiniz. API anahtarını, projenizin kimlik bilgilerinin "API anahtarları" bölümünde de bulabilirsiniz.
    • Gelişmiş ayarları güncellemek ve API anahtarınızın kullanımını sınırlamak için Anahtarı kısıtla'yı tıklayın. Daha ayrıntılı bilgi için API anahtarı kısıtlamaları uygulama başlıklı makaleyi inceleyin.

Chat API'yi çağıran bir komut dosyası yazma

Uygulama kimlik doğrulaması ile üyeliği silme

Python

  1. Çalışma dizininizde chat_membership_delete_app.py adlı bir dosya oluşturun.

  2. chat_membership_delete_app.py dosyasına aşağıdaki kodu ekleyin:

    from google.oauth2 import service_account
from apiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.app.memberships"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then deletes the specified membership.
    '''

    # Specify service account details.
    creds = (
        service_account.Credentials.from_service_account_file('credentials.json')
        .with_scopes(SCOPES)
    )

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY')

    # Use the service endpoint to call Chat API.
    result = chat.spaces().members().delete(

        # The membership to delete.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MEMBER with a membership name.
        # Obtain the membership name from the memberships resource of
        # Chat API. To delete a Chat app's membership, replace MEMBER
        # with app; an alias for the app calling the API.
        name='spaces/SPACE/members/MEMBER'

    ).execute()

    # Print Chat API's response in your command line interface.
    # When deleting a membership, the response body is empty.
    print(result)

if __name__ == '__main__':
    main()

  3. Kodda aşağıdakileri değiştirin:

    • API_KEY: derlemek için oluşturduğunuz API anahtarı Chat API için hizmet uç noktası.

    • SPACE: şuradan alabileceğiniz bir alan adı: spaces.list yöntemi API'den veya bir alanın URL'sinden.

    • MEMBER: Edinebileceğiniz bir üyelik adı spaces.members.list yönteminden hakkındaki makalemizi incelemenizi öneririz. Bir uygulamanın üyeliğini silmek için MEMBER yerine app yazın.

  4. Çalışma dizininizde örneği derleyin ve çalıştırın:

    python3 chat_membership_delete_app.py

İşlem başarılı olursa yanıt gövdesi, üyeliğin 'state': 'NOT_A_MEMBER' ile döndürülmesini sağlar. Bu, üyenin artık alanda olmadığını gösterir.

{
    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"
}

Sınırlamalar ve dikkat edilmesi gereken hususlar

Bir alandan Google Workspace yöneticisi sıfatını alan kullanıcıları veya Google Gruplarını kaldırma

Google Workspace yöneticisiyseniz kullanıcıları, Google Gruplar'ı veya Chat uygulamalarını Google Workspace kuruluşunuzdaki herhangi bir alandan kaldırmak için DeleteMembership() yöntemini çağırabilirsiniz.

Bu yöntemi Google Workspace yöneticisi olarak çağırmak için aşağıdakileri yapın:

  • Kullanıcı kimlik doğrulamasını kullanarak yöntemi çağırın ve yöntemin yönetici ayrıcalıkları kullanılarak çağrılmasını destekleyen bir yetkilendirme kapsamı belirtin.
  • İsteğinizde useAdminAccess sorgu parametresini true olarak belirtin.

Daha fazla bilgi ve örnek için Google Chat alanlarını Google Workspace yöneticisi olarak yönetme başlıklı makaleyi inceleyin.