Alanı silme

Bu kılavuzda, Google Chat API'nin Space kaynağında delete() yönteminin nasıl kullanılacağı açıklanmaktadır. Bu yöntem, artık ihtiyaç duyulmayan adlandırılmış bir alanı silmek için kullanılır. Bir alanı sildiğinizde, mesajlar ve ekler de dahil olmak üzere içerdiği her şey silinir.

Google Workspace yöneticisiyseniz Google Workspace kuruluşunuzdaki tüm adlandırılmış alanları silmek için delete() yöntemini çağırabilirsiniz.

Space Kaynağı, kullanıcıların ve Chat uygulamalarının mesaj gönderebileceği, dosya paylaşabileceği ve ortak çalışma yapabileceği bir yeri temsil eder. Birkaç tür alan vardır:

  • Doğrudan mesajlar (DM), iki kullanıcı veya bir kullanıcı ile bir Chat uygulaması arasındaki görüşmelerdir.
  • Grup sohbetleri, üç veya daha fazla kullanıcı ile sohbet uygulamaları arasındaki görüşmelerdir.
  • Adlandırılmış alanlar, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalıştığı kalıcı yerlerdir.

Ön koşullar

Node.js

Bir kullanıcının adlandırılmış alanı silmesi

Google Chat'te kullanıcı kimlik doğrulaması olan mevcut bir alanı silmek için isteğinizde aşağıdakileri iletin:

  • chat.delete yetkilendirme kapsamını belirtin.
  • DeleteSpace() yöntemini çağırın.
  • Silinecek alanın name değerini iletin.

Alan silmek için aşağıdaki adımları uygulayın:

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 SPACE_NAME yerine alanın name alanındaki kimliği girin. Kimliği ListSpaces() yöntemini çağırarak veya alanın URL'sinden alabilirsiniz.

Adlandırılmış bir alanı Chat uygulaması olarak silme

Uygulama kimlik doğrulaması için tek seferlik yönetici onayı gerekir.

Uygulama kimlik doğrulaması ile yalnızca sohbet uygulamaları tarafından oluşturulan alanları silebilirsiniz.

Google Chat'te uygulama kimlik doğrulaması ile mevcut bir alanı silmek için isteğinizde aşağıdakileri iletin:

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

Alan silmek için aşağıdaki adımları uygulayın:

Python

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

  2. chat_space_delete_app.py'ya 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.delete"]

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

    # 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)

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

          # The space 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.
          name='spaces/SPACE'

      ).execute()

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

if __name__ == '__main__':
    main()

  3. Koddaki aşağıdaki yerleri değiştirin:

    • SPACE ile birlikte alan adını kullanın. Alan adını Chat API'deki spaces.list yönteminden veya bir alanın URL'sinden alabilirsiniz.

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

    python3 chat_space_delete_app.py

Başarılı olursa yanıt gövdesi boş olur. Bu, alanın silindiğini gösterir.

Google Workspace yöneticisi olarak adlandırılmış bir alanı silme

Google Workspace yöneticisiyseniz Google Workspace kuruluşunuzdaki tüm adlandırılmış alanları silmek için DeleteSpace() 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ıyla 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 Workspace yöneticisi olarak Google Chat alanlarını yönetme başlıklı makaleyi inceleyin.