Bu sayfada, subscriptions.update()
yöntemini kullanarak Google Workspace aboneliğinin nasıl yenileneceği açıklanmaktadır. Bu yöntemi, aboneliğin geçerlilik süresini güncellemek (ör. aboneliği mümkün olan en uzun geçerlilik süresi için yenilemek) veya hedef kaynakla ilgili alınacak etkinlik türlerinin listesini güncellemek için kullanabilirsiniz.
Apps Komut Dosyası
- Google Workspace aboneliği Abonelik oluşturmak için Abonelik oluşturma başlıklı makaleyi inceleyin.
Abonelikle ilgili tüm etkinlik türlerini destekleyen bir veya daha fazla kapsam ile kullanıcı kimlik doğrulaması gerektirir.
- Bir 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 için kapsamları Apps Komut Dosyası projenizdeki
appsscript.json
dosyasına da eklemeniz gerekir. Örneğin,chat.messages
kapsamını belirttiyseniz aşağıdakileri ekleyin: Google Workspace Events
gelişmiş hizmetini etkinleştirin.
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages" ]
Python
- Python 3.6 veya sonraki sürümler
- pip paket yönetim aracı
- Python için en yeni Google istemci kitaplıkları. Bu araçları 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.
Abonelikle ilgili tüm etkinlik türlerini destekleyen bir veya daha fazla kapsam ile kullanıcı kimlik doğrulaması gerektirir.
Google Workspace aboneliğini yenileme
Bu bölümde, Google Workspace Events API'nin subscriptions.update()
yöntemini kullanarak bir aboneliği maksimum geçerlilik süresine kadar yenileyeceksiniz. Maksimum geçerlilik bitiş zamanını belirtmek için ttl
alanını Subscription
kaynağında 0
olarak güncellersiniz.
Maksimum geçerlilik süresi, etkinlik yüküne hangi kaynak verilerinin dahil edildiğine bağlıdır. Son kullanma süreleri 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ı
Apps Komut Dosyası projenizde
updateSubscription
adlı yeni bir komut 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:
Google Workspace aboneliğini güncellemek için Apps Komut Dosyası projenizde
updateSubscription
işlevini çalıştırın.
Python
Ç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('credentials.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:
Çalışma dizininizde OAuth istemci kimliği kimlik bilgilerinizi sakladığınızdan ve dosyayı
credentials.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 bilgileri oluşturma başlıklı makaleye bakın.Google Workspace aboneliğini güncellemek için terminalinizde aşağıdakileri çalıştırın:
python3 update_subscription.py
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 Operation
kaynağı belirtirseniz yanıt boş olur.