Google Workspace aboneliğini güncelleme veya yenileme

Bu sayfada, subscriptions.update() yöntemini kullanarak Google Workspace aboneliğini nasıl yenileyeceğiniz açıklanmaktadır. Bu yöntemi, aboneliğin geçerlilik bitiş süresini güncellemek (aboneliği mümkün olan en uzun geçerlilik bitiş süresi için yenilemek dahil) veya hedef kaynak hakkında alınacak etkinlik türlerinin listesini güncellemek için kullanabilirsiniz.

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ğini yenileme

Bu bölümde, bir aboneliği maksimum son kullanma süresine kadar yenilemek için Google Workspace Events API'nin subscriptions.update() yöntemini kullanırsınız. Maksimum son kullanma zamanını belirtmek için Subscription kaynağının ttl alanını 0 olarak güncelleyebilirsiniz.

Maksimum geçerlilik bitiş süresi, etkinlik yüküne hangi kaynak verilerinin dahil edildiğine bağlıdır. Süre sonu tarihleri hakkında daha fazla bilgi edinmek için Google Workspace etkinlikleri için etkinlik verileri başlıklı makaleyi inceleyin.

Google Workspace aboneliğini yenilemek için:

Apps Komut Dosyası

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

    function updateSubscription() {
  // The name of the subscription to update.
  const name = 'subscriptions/SUBSCRIPTION_ID';

  // Call the Workspace Events API using the advanced service.
  const response = WorkspaceEvents.Subscriptions.patch({
    ttl: '0s',
  }, name);
  console.log(response);
}

    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. Google Workspace aboneliğini güncellemek için Apps Komut Dosyası projenizde updateSubscription işlevini çalıştırın.

Python

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

    """Update subscription."""

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Specify required scopes.
SCOPES = [SCOPES]

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

BODY = {
    'ttl': {'seconds': 0},
}
NAME = 'subscriptions/SUBSCRIPTION_ID'
response = (
    service.subscriptions()
    .patch(name=NAME, updateMask='ttl', body=BODY)
    .execute()
)
print(response)

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

    • SCOPES: Abonelik için her etkinlik türünü destekleyen bir veya daha fazla OAuth kapsamı. Dize dizisi olarak biçimlendirilir. Birden fazla kapsamı listelemek için virgülle ayırın. Örneğin, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'.
    • 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. Google Workspace aboneliğini güncellemek için terminalinizde aşağıdakileri çalıştırın:

    python3 update_subscription.py
Google Workspace Events API, Subscription kaynağının örneğini içeren bir uzun süreli işlem döndürür.

Güncellenen Subscription kaynağıyla ilgili ayrıntıları almak için operations.get() yöntemini kullanın ve subscriptions.update() isteğinizden döndürülen Operation kaynağını belirtin. Aksi takdirde, aboneliğin önceki bir sürümünden bir Operation kaynağı belirtirseniz yanıt boş olur.