Filtrando usuários por OU no Google Apps Script

Tá, agora você já sabe como fazer uma pesquisa por OU na caixa de busca do Google Admin. E se eu quero esse filtro nos meus Scripts, pra reduzir o tempo de computação e não chegar nos limites do Apps Script?

Também é possível. Se você já programou algo pra ser efetivado em todos os usuários do seu domínio, você já deve ter visto um código desse:

  
  var pageToken;
  var page;
  
  do {
    page = AdminDirectory.Users.list({
      domain: 'domain.com.br',
      maxResults: 500,
      pageToken: pageToken,
    });
    var users = page.users;
    if (users) {
      // Se o usuário existe, então posso fazer algo aqui com todos eles de uma vez.
    }
    pageToken = page.nextPageToken;
  } while (pageToken);
  

O que é (pra mim) uma novidade positiva, é que ao instanciar o objeto Page, é possível também usar o atributo query, onde podemos colocar qualquer filtro de pesquisa que for também válido na caixa de busca da tela principal do Admin.

O código modificado fica assim:

  
  var pageToken;
  var page;
  
  do {
    page = AdminDirectory.Users.list({
      domain: 'domain.com.br',
      maxResults: 500,
      query: 'string pesquisa',
      pageToken: pageToken,
    });
    var users = page.users;
    if (users) {
      // Se o usuário existe, então posso fazer algo aqui com todos eles de uma vez.
    }
    pageToken = page.nextPageToken;
  } while (pageToken);
  

Esse código, com a adição da linha 8 (a propriedade query), vai trazer somente os usuários que obedecem ao filtro de pesquisa definido.