1

Currently, the Google Vault API does not provide a way to get a report of all users in a G-Suite tenant or domain who are on hold in one or more matters. This information is currently available only via the admin interface for Google Vault under Reports/User Holds. It would be great to be able to obtain this report via an API call in JSON format rather than only via the admin UI. Am I missing something or is this functionality already available?

Respectfully, please keep in mind that suggesting that I perform API operations to search all matters and iterate through the users on hold in each matter to obtain this information is not the answer I am looking for. There should be a quicker, more efficient way to get this information since such a report is already available via the UI. I am simply asking if there is a way to get this same information programmatically via the APIs/automation.

enter image description here

halfer
  • 19,824
  • 17
  • 99
  • 186
tfrancois
  • 175
  • 10

1 Answers1

1

Unfortunately, Vault API does not have a method for that. The only way to retrieve this information is to list all matters and iterate through them, as you already mentioned.

File a feature request:

It's not uncommon for a feature to be present only in the UI. If you want to see this implemented on the API, I'd suggest you to report it on Issue Tracker's Vault component.

I looked through the issues of this component, and it looks like this hasn't been requested yet. There's currently a somewhat related feature request, but not exactly what you're looking for:

Update:

The original poster filed a feature request in Issue Tracker. I'm add this to the answer in order to give it more visibility.

To anyone who would like to see this feature implemented in the future, I'd suggest starring the issue (star on the top-left) in order to help prioritizing it:

Iamblichus
  • 18,540
  • 2
  • 11
  • 27
  • Thanks for your reply @Iamblichus. Do you work for GSuite support by any chance? It doesn't indicate so in your bio. – tfrancois Sep 24 '20 at 17:56
  • Thank you, here is why I asked. Why would your suggestion (of which I already surmised was the only available option) of looping through any number of matters (which theoretically be in the hundreds) and then subsequently iterating through all the users in those matters be beneficial to either me (quota limits) or GSuite (increased exponential traffic and overhead for having to make such requests for each user I need this info for, which could be thousands). Isn't it better to simply expose the functionality utilized in the UI to the API since it already exists? I ask with all due respect. – tfrancois Sep 24 '20 at 22:03
  • In the meanwhile, I've created the feature request as suggested in the Issue Tracker for Vault: https://issuetracker.google.com/169333424 – tfrancois Sep 24 '20 at 22:17
  • @tfrancois It's a workaround. The functionality you desire is not available yet, and meanwhile the iteration process, if not ideal, is the only way to go. – Iamblichus Sep 25 '20 at 05:57
  • @tfrancois Thank you for creating this FR. I updated my answer with this so that it gets more visibility. – Iamblichus Sep 25 '20 at 10:17