Deletes a guardian. The guardian will no longer receive guardian notifications and the guardian will no longer be accessible via the API. This method returns the following error codes: * PERMISSION_DENIED
if no user that matches the provided student_id
is visible to the requesting user, if the requesting user is not permitted to manage guardians for the student identified by the student_id
, if guardians are not enabled for the domain in question, or for other access errors. * INVALID_ARGUMENT
if a student_id
is specified, but its format cannot be recognized (it is not an email address, nor a student_id
from the API). * NOT_FOUND
if the requesting user is permitted to modify guardians for the requested student_id
, but no Guardian
record exists for that student with the provided guardian_id
.
Scopes
You will need authorization for the https://www.googleapis.com/auth/classroom.guardianlinks.students scope to make a valid call.
If unset, the scope for this method defaults to https://www.googleapis.com/auth/classroom.guardianlinks.students.
You can set the scope for this method like this: classroom1 --scope <scope> user-profiles guardians-delete ...
Required Scalar Arguments
- <student-id> (string)
- The student whose guardian is to be deleted. One of the following: * the numeric identifier for the user * the email address of the user * the string literal
"me"
, indicating the requesting user
- The student whose guardian is to be deleted. One of the following: * the numeric identifier for the user * the email address of the user * the string literal
- <guardian-id> (string)
- The
id
field from aGuardian
.
- The
Optional Output Flags
The method's return value a JSON encoded structure, which will be written to standard output by default.
- -o out
- out specifies the destination to which to write the server's result to.
It will be a JSON-encoded structure.
The destination may be
-
to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.
- out specifies the destination to which to write the server's result to.
It will be a JSON-encoded structure.
The destination may be
Optional General Properties
The following properties can configure any call, and are not specific to this method.
-
-p $-xgafv=string
- V1 error format.
-
-p access-token=string
- OAuth access token.
-
-p alt=string
- Data format for response.
-
-p callback=string
- JSONP
-
-p fields=string
- Selector specifying which fields to include in a partial response.
-
-p key=string
- API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
-
-p oauth-token=string
- OAuth 2.0 token for the current user.
-
-p pretty-print=boolean
- Returns response with indentations and line breaks.
-
-p quota-user=string
- Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
-
-p upload-type=string
- Legacy upload protocol for media (e.g. "media", "multipart").
-
-p upload-protocol=string
- Upload protocol for media (e.g. "raw", "multipart").