I'm trying to set a new user's Building id using the .NET Google Admin SDK. I'm using the Locations property to do that.

Here's Building id in the Google Admin Console:

And in my code:

var newUser = new User()
{
    // ...
};

// ...

newUser.Locations = new List<UserLocation>()
{
    new()
    {
        BuildingId = command.BuildingId,
    }
};

// ...

var request = _service.Users.Insert(newUser);
var user = await request.ExecuteAsync();

The last line throws Google.GoogleApiException:

The service admin has thrown an exception. HttpStatusCode is BadRequest. Required parameter: [resource.location.field[0].Value]

I'm trying to set a new user's Building id using the .NET Google Admin SDK. I'm using the Locations property to do that.

Here's Building id in the Google Admin Console:

And in my code:

var newUser = new User()
{
    // ...
};

// ...

newUser.Locations = new List<UserLocation>()
{
    new()
    {
        BuildingId = command.BuildingId,
    }
};

// ...

var request = _service.Users.Insert(newUser);
var user = await request.ExecuteAsync();

The last line throws Google.GoogleApiException:

The service admin has thrown an exception. HttpStatusCode is BadRequest. Required parameter: [resource.location.field[0].Value]

• c#
• google-admin-sdk

1 Answer 1

tl;dr: Set Area and Type to desk

newUser.Locations = new List<UserLocation>()
{
    new()
    {
        Area = "desk",
        BuildingId = command.BuildingId,
        Type = "desk",
    }
};

Explanation

There are two issues with the code in my question:

1. The location's Area property is required. This doesn't seem to be documented.

   The below change eliminates the exception. However, the building ID doesn't show up in the GUI.

   newUser.Locations = new List<UserLocation>()
   {
       new()
       {
           Area = "desk",
           BuildingId = command.BuildingId,
       }
   };
   

2. For the building ID to show up in the GUI, Type must also be set. Based on what the GUI sets Type and Area to when you set Building id there, it looks like both properties need to be set to desk.

   With the change below, the building ID now shows up in the GUI under Employee info:

   newUser.Locations = new List<UserLocation>()
   {
       new()
       {
           Area = "desk",
           BuildingId = command.BuildingId,
           Type = "desk",
       }
   };
   

Methodology

I discovered this by setting Building id in the GUI, then getting the user through the API.

In the .NET Google Admin SDK, Locations is, unfortunately, of type object. At runtime, you can see it's a Newtonsoft array. I wrote an extension class that I hereby dedicate to the public domain:

using Google.Apis.Admin.Directory.directory_v1.Data;
using Newtonsoft.Json;

namespace Your.Namespace.Here;

public static class UserExtensions
{
    public static List<UserLocation> GetLocations(this User user)
    {
        if (user.Locations is null)
        {
            return [];
        }

        return JsonConvert.DeserializeObject<List<UserLocation>>(user.Locations.ToString()!)!;
    }
}