Bir alanı güncelleme (original) (raw)

Bu kılavuzda, Google Chat API'nin Space kaynağında bulunan patch() yönteminin bir alanı güncellemek için nasıl kullanılacağı açıklanmaktadır. Bir alanla ilgili kullanıcılar tarafından görünen ad, açıklama ve yönergeler gibi özellikleri değiştirmek için alanı güncelleyin.

Google Workspace yöneticisiyseniz Google Workspace kuruluşunuzdaki mevcut alanları güncellemek için patch() 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:

Ön koşullar

Node.js

Python

Java

Apps Komut Dosyası

Bir alanı kullanıcı olarak güncelleme

Google Chat'teki mevcut bir alanı kullanıcı kimlik doğrulaması ile güncellemek için isteğinizde aşağıdakileri iletin:

Görünen ad, alan türü, geçmiş durumu gibi bilgileri güncelleyebilirsiniz. Güncelleyebileceğiniz tüm alanları görmek için referans belgelerine bakın.

Mevcut bir alanın displayName alanını şu şekilde güncelleyebilirsiniz:

Node.js

Python

Java

Apps Komut Dosyası

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.

Google Chat API, güncellemeleri yansıtan bir Space örneği döndürür.

Google Workspace yöneticisi olarak alanı güncelleme

Google Workspace yöneticisiyseniz Google Workspace kuruluşunuzdaki herhangi bir alanı güncellemek için UpdateSpace() yöntemini çağırabilirsiniz.

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

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

Bir alanı Chat uygulaması olarak güncelleme

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

Google Chat'teki mevcut bir alanı uygulama kimlik doğrulaması ile güncellemek için isteğinizde aşağıdakileri iletin:

Görünen ad, alan türü, geçmiş durumu ve izin ayarları gibi bilgileri güncelleyebilirsiniz. Güncelleyebileceğiniz tüm alanları görmek için referans belgelerine bakın.

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

Mevcut bir alanın spaceDetails alanını şu şekilde güncelleyebilirsiniz:

Python

  1. Çalışma dizininizde chat_space_update_app.py adlı bir dosya oluşturun.
  2. chat_space_update_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.spaces"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then updates the specified space description and guidelines.  
    '''  
    # 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().patch(  
      # The space to update, and the updated space details.  
      #  
      # 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',  
      updateMask='spaceDetails',  
      body={  
        'spaceDetails': {  
          'description': 'This description was updated with Chat API!',  
          'guidelines': 'These guidelines were updated with Chat API!'  
        }  
      }  
    ).execute()  
    # Prints details about the updated space.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. Koddaki aşağıdaki yerleri değiştirin:
    • SPACE ile alan adını kullanarak. Alan adını Chat API'deki spaces.list yönteminden veya bir alanın URL'sinden alabilirsiniz.
  2. Çalışma dizininizde örneği oluşturun ve çalıştırın:
python3 chat_space_update_app.py

Google Chat API, güncellemeleri yansıtan bir Space kaynağı örneği döndürür.

Sınırlamalar ve dikkat edilmesi gereken noktalar