Alandaki üyeleri listeleme

Bu kılavuzda, membership kaynağında list yönteminin nasıl kullanılacağı açıklanmaktadır. bir alandaki üyeleri sayfalara ayrılmış ve filtrelenebilir bir liste olarak listelemek için Google Chat API'nin özel olarak nitelendirilir. Üyeliklerin listelenmesi: uygulama kimlik doğrulaması Chat uygulamasının sahip olduğu alanlardaki üyelikleri listeler Chat uygulaması üyeliklerini hariç tutar, ancak şunlar dahil değildir: sahip olmalıdır. Üyeliklerin listelenmesi: Kullanıcı kimlik doğrulaması Kimliği doğrulanmış kullanıcının erişebildiği alanlardaki üyelikleri listeler.

İlgili içeriği oluşturmak için kullanılan Membership kaynak bir gerçek kullanıcının veya Google Chat uygulamasının davet edilip edilmediğini bir alanın parçası olan ya da olmayan

Ön koşullar

Python

  • Python 3.6 veya sonraki sürümler
  • pip paket yönetim aracı
  • En yeni Google istemci kitaplıkları. Bu uygulamaları 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

Kullanıcı kimlik doğrulamasıyla alandaki üyeleri listeleyin

Bir alandaki kullanıcıları, Google Gruplar'ı ve Chat uygulamasını listelemek için erişimi olan kullanıcıların erişim iznine sahip olması gerekiyorsa aşağıdaki bilgileri isteğinizde iletin:

Aşağıdaki örnekte, şu kullanıcılara görünür olan Google Grubu, gerçek kişi ve uygulama üyeleri listelenmektedir: kimlik doğrulaması yapılmış olmalıdır.

Python

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

  2. Aşağıdaki kodu chat_member_list_user.py bölümüne ekleyin:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.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.memberships.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then lists Google Group, human, and app members in a specified space.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

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

        # The space for which to list memberships.
        parent = 'spaces/SPACE',

        # Set this parameter to list Google Groups.
        showGroups = 'true'

    ).execute()

    # Prints the list of memberships.
    print(result)

if __name__ == '__main__':
    main()

  3. Kodda, SPACE öğesini bir alan adıyla değiştirin. şuradan edinebilirsiniz: spaces.list yöntem API'den veya bir alanın URL'sinden.

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

    python3 chat_member_list_user.py

Google Chat API, belirtilen boşluk.

Uygulama kimlik doğrulamasıyla alandaki üyeleri listeleyin

Bir alandaki kullanıcıları ve Chat uygulamasını listelemek için erişimi varsa isteğinizde aşağıdakileri iletin:

Aşağıdaki örnekte, şu kullanıcılara görünür olan gerçek kişi alan üyeleri (alan yöneticileri değil) listelenmektedir: Chat uygulamasında:

Python

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

  2. Aşağıdaki kodu chat_member_list_app.py bölümüne ekleyin:

    from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

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

        # The space for which to list memberships.
        parent = 'spaces/SPACE',

        # An optional filter that returns only human space members.
        filter = 'member.type = "HUMAN" AND role = "ROLE_MEMBER"'

    ).execute()

print(result)

  3. Kodda, SPACE öğesini bir alan adıyla değiştirin. şuradan edinebilirsiniz: spaces.list yöntem API'den veya bir alanın URL'sinden.

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

    python3 chat_member_list_app.py

Google Chat API, insan alanı üyelerinin (alan hariç) listesini döndürür yöneticileri).

Sayfalara ayırma veya listeyi filtreleme

Üyelikleri listelemek için aşağıdaki sorgu parametrelerini şuraya geçirin: listelenen üyelikleri sayfalara ayırma veya filtreleme:

  • pageSize: Döndürülecek maksimum üyelik sayısı. Hizmet, bu değerden daha azını döndürür. Belirtilmemişse en fazla 100 alan geri döndü. Maksimum değer 1.000'dir; 1000'in üzerindeki değerler otomatik olarak 1000 olarak değiştirildi.
  • pageToken: Önceki bir alan liste çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu jetonu sağlayın. Sayfalara ayırırken filtre değerinin, sayfa jetonunu sağlayan çağrıyla eşleşmesi gerekir. Doğru cevap beklenmedik sonuçlara yol açabilir.
  • filter: Sorgu filtresi. Gereken kullanıcı kimlik doğrulaması. Desteklenen sorgu ayrıntıları için bkz. spaces.members.list yöntemini kullanın.