Google Workspace aboneliğiyle ilgili ayrıntıları öğrenme

Bu sayfada, subscriptions.get() yöntemini kullanarak bir Google Workspace aboneliğiyle ilgili ayrıntıların nasıl alınacağı açıklanmaktadır.

Bu yöntemi kullanıcı kimlik doğrulamasıyla çağırdığınızda yöntem, kullanıcı tarafından yetkilendirilmiş bir abonelikle ilgili ayrıntıları döndürür. Uygulama kimlik doğrulamasını kullandığınızda yöntem, uygulamanın abonelikleriyle ilgili ayrıntıları döndürebilir.

Ön koşullar

Apps Komut Dosyası

  • Apps Komut Dosyası projesi:
    • Apps Komut Dosyası tarafından otomatik olarak oluşturulan varsayılan proje yerine Google Cloud projenizi kullanın.
    • OAuth izin ekranını yapılandırmak için eklediğiniz tüm kapsamları, Apps Komut Dosyası projenizdeki appsscript.json dosyasına da eklemeniz gerekir. Örneğin:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Google Workspace Events gelişmiş hizmetini etkinleştirin.

Python

  • Python 3.6 veya sonraki sürümler
  • pip paket yönetim aracı
  • Python için en son Google istemci kitaplıkları. Bunları yüklemek veya güncellemek için komut satırı arayüzünüzde aşağıdaki komutu çalıştırın:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
  • Google Workspace aboneliği Abonelik oluşturmak için Abonelik oluşturma başlıklı makaleyi inceleyin.

  • Kimlik doğrulama gerektirir:

    • Kullanıcı kimlik doğrulaması için aboneliğin etkinlik türlerinden en az birini destekleyen bir kapsam gerekir. Bir kapsamı tanımlamak için Etkinlik türüne göre kapsamlar başlıklı makaleyi inceleyin.
    • Uygulama kimlik doğrulaması için chat.bot kapsamı (yalnızca Google Chat uygulamaları) gerekir.

Kullanıcı tarafından yetkilendirilmiş bir abonelik alma

Aşağıdaki kod örneği, kullanıcı kimlik doğrulamasını kullanarak bir Subscription kaynağıyla ilgili ayrıntıları alır. Kullanıcı olarak kimlik doğrulaması yapıldığında yöntem, kullanıcının uygulamanın oluşturması için yetkilendirdiği bir aboneliği döndürür.

Kullanıcı tarafından yetkilendirilmiş bir abonelik almak için:

Apps Komut Dosyası

  1. Apps Komut Dosyası projenizde getSubscription adlı yeni bir komut dosyası dosyası oluşturun ve aşağıdaki kodu ekleyin:

    function getSubscription() {
      // The name of the subscription to get.
      const name = 'subscriptions/SUBSCRIPTION_ID';
    
      // Call the Workspace Events API using the advanced service.
      const subscription = WorkspaceEvents.Subscriptions.get(name);
      console.log(subscription);
    }
    

    Aşağıdakini değiştirin:

    • SUBSCRIPTION_ID: Aboneliğin kimliği. Kimliği almak için aşağıdakilerden herhangi birini kullanabilirsiniz:
      • uid alanının değeri.
      • name alanında temsil edilen kaynak adının kimliği. Örneğin, kaynak adı subscriptions/subscription-123 ise subscription-123 değerini kullanın.
  2. Aboneliği almak için Apps Komut Dosyası projenizde getSubscription işlevini çalıştırın.

Python

  1. Çalışma dizininizde get_subscription.py adlı bir dosya oluşturun ve aşağıdaki kodu ekleyin:

    """Get subscription."""
    
    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    
    # Specify required scopes.
    SCOPES = ['SCOPE']
    
    # Authenticate with Google Workspace and get user authentication.
    flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
    CREDENTIALS = flow.run_local_server()
    
    # Call the Workspace Events API using the service endpoint.
    service = build(
        'workspaceevents',
        'v1',
        credentials=CREDENTIALS,
    )
    
    NAME = 'subscriptions/SUBSCRIPTION_ID'
    subscription = service.subscriptions().get(name=NAME).execute()
    print(subscription)
    

    Aşağıdakini değiştirin:

    • SCOPE: Abonelikten en az bir etkinlik türünü destekleyen bir OAuth kapsamı. Örneğin, aboneliğiniz güncellenmiş bir Chat alanı https://www.googleapis.com/auth/chat.spaces.readonly için etkinlik alıyorsa.
    • SUBSCRIPTION_ID: Aboneliğin kimliği. Kimliği almak için aşağıdakilerden herhangi birini kullanabilirsiniz:
      • uid alanının değeri.
      • name alanında temsil edilen kaynak adının kimliği. Örneğin, kaynak adı subscriptions/subscription-123 ise subscription-123 değerini kullanın.
  2. Çalışma dizininizde OAuth istemci kimliği kimlik bilgilerinizi kaydettiğinizden ve dosyayı client_secrets.json olarak adlandırdığınızdan emin olun. Kod örneği, Google Workspace ile kimlik doğrulaması yapmak ve kullanıcı kimlik bilgilerini almak için bu JSON dosyasını kullanır. Talimatlar için OAuth istemci kimliği kimlik bilgilerini oluşturma başlıklı makaleyi inceleyin.

  3. Aboneliği almak için terminalinizde aşağıdakileri çalıştırın:

    python3 get_subscription.py