Add Support for UserRelations

[mattwoolnough]

Add Support for UserRelation

https://developers.google.com/resources/api-libraries/documentation/admin/directory_v1/java/latest/com/google/api/services/admin/directory/model/class-use/UserRelation.html

[mattwoolnough]

Looking for some ideas on how to implement the deletion of relations.

To remove a relation via the HTTP API, a PUT of an empty JSON array is required:

{
 "relations": []  
}

[scrthq]

@mattwoolnough - I believe I implemented something on another function for a similar purpose, let me try and dig it out. IIRC, you need to set the value as an empty generic list if the parameter is used in $PSBoundParameters but is $null. Give me a bit =]

[mattwoolnough]

Sorry, to delete the JSON below is required. Did you happen to find the code you were thinking of?

{
 "relations": null  
}

[scrthq]

@mattwoolnough - still hunting for it, but I know that the .NET SDK regards sending $null as not being sent at all, not a deliberate $null. I see your PR as well. I've been pretty slammed with normal work + family + holidays, so my sincere apologies for not being as quick on the response and deploying your PR's as well! Working on pulling in a few additional things into the next release as well if possible, so it's been a battle.

[scrthq]

have you tried just sending $null as the value for that property with a call to Update-GSUser? The section in the switch statement should still create a blank list and submit that, if I remember correctly.

[scrthq]

disregard, just tested and that didn't do anything (at least for Relations anyway)

[scrthq]

Alright, found the bit of code that I was thinking of similar to removing values:

#16 (comment)

Did some testing based on this and the following works (although is does leave a null reference for the Relation value when pulling the user information via API):

---

Before (view from Admin console and view from $user.Relations):

---

After:

Update-GSUser -User $user.PrimaryEmail -Relations (Add-GSUserRelation -Type manager -Value $null)

[scrthq]

alright, that's going to be the only applicable approach for clearing the value of a single relation/phone/etc. I've looked at your code in your PR for Remove-GSUserPhone and have applied something more widespread directly on Update-GSUser to allow passing $null as the value to clear out all entries for that property type.

Example in use:

Update-GSUser -User $user.PrimaryEmail -Relations $null

[scrthq]

@mattwoolnough - Thanks for the contributions around this! UserRelation support is out now in v2.21.0. I've also included the updated logic for clearing out ExternalIds, Phones, Relations, and Organizations into Update-GSUser via passing $null as the value for those parameters. As noted, if you need to clear out a specific item, just pass $null for the value of the item on the appropriate helper function.

Let me know if you have any questions regarding this!