testers

Creates, updates, deletes, gets or lists a testers resource.

Overview

Name	testers
Type	Resource
Id	firebase.appdistribution.testers

Fields

The following fields are returned by SELECT queries:

list

Successful response

Name	Datatype	Description
name	string	The name of the tester resource. Format: projects/{project_number}/testers/{email_address}
displayName	string	The name of the tester associated with the Google account used to accept the tester invitation.
groups	array	The resource names of the groups this tester belongs to.
lastActivityTime	string (google-datetime)	Output only. The time the tester was last active. This is the most recent time the tester installed one of the apps. If they've never installed one or if the release no longer exists, this is the time the tester was added to the project.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	projectsId	pageSize, pageToken, filter	Lists testers and their resource ids.
patch	update	projectsId, testersId	updateMask	Update a tester. If the testers joins a group they gain access to all releases that the group has access to.
batch_add	exec	projectsId		Batch adds testers. This call adds testers for the specified emails if they don't already exist. Returns all testers specified in the request, including newly created and previously existing testers. This action is idempotent.
batch_remove	exec	projectsId		Batch removes testers. If found, this call deletes testers for the specified emails. Returns all deleted testers.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
projectsId	string
testersId	string
filter	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)

SELECT examples

list

Lists testers and their resource ids.

SELECT
name,
displayName,
groups,
lastActivityTime
FROM firebase.appdistribution.testers
WHERE projectsId = '{{ projectsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

UPDATE examples

patch

Update a tester. If the testers joins a group they gain access to all releases that the group has access to.

UPDATE firebase.appdistribution.testers
SET 
data__name = '{{ name }}',
data__displayName = '{{ displayName }}',
data__groups = '{{ groups }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND testersId = '{{ testersId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
displayName,
groups,
lastActivityTime;

Lifecycle Methods

batch_add

Batch adds testers. This call adds testers for the specified emails if they don't already exist. Returns all testers specified in the request, including newly created and previously existing testers. This action is idempotent.

EXEC firebase.appdistribution.testers.batch_add 
@projectsId='{{ projectsId }}' --required 
@@json=
'{
"emails": "{{ emails }}"
}';

batch_remove

Batch removes testers. If found, this call deletes testers for the specified emails. Returns all deleted testers.

EXEC firebase.appdistribution.testers.batch_remove 
@projectsId='{{ projectsId }}' --required 
@@json=
'{
"emails": "{{ emails }}"
}';