Get started with the .NET SDK

<ItemGroup>
  <PackageReference Include="commercetools.Sdk.Api" Version="*" />
  <PackageReference Include="commercetools.Sdk.ImportApi" Version="*" />
  <PackageReference Include="commercetools.Sdk.HistoryApi" Version="*" />
</ItemGroup>

// The following imports are required:
// using commercetools.Sdk.Api;
// using commercetools.Sdk.Api.Client;
// using Microsoft.Extensions.Configuration;
// using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
var configuration = new ConfigurationBuilder()
  .AddInMemoryCollection(new List<KeyValuePair<string, string>>()
  {
    new KeyValuePair<string, string>("MyClient:ApiBaseAddress", "https://api.{region}.commercetools.com/"),
    new KeyValuePair<string, string>("MyClient:AuthorizationBaseAddress", "https://auth.{region}.commercetools.com/"),
    new KeyValuePair<string, string>("MyClient:ClientId", "{clientID}"),
    new KeyValuePair<string, string>("MyClient:ClientSecret", "{clientSecret}"),
    new KeyValuePair<string, string>("MyClient:ProjectKey", "{projectKey}"),
    new KeyValuePair<string, string>("MyClient:Scope", "{scope}")
  })
.Build();

services.UseCommercetoolsApi(configuration, "MyClient");
services.AddLogging();

var serviceProvider = services.BuildServiceProvider();
var projectApiRoot = serviceProvider.GetService<ProjectApiRoot>();

// Make a call to get the Project
var myProject = projectApiRoot
  .Get()
  .ExecuteAsync()
  .Result;

// Output the Project name
Console.WriteLine(myProject.Name);

using commercetools.Sdk.Api.Models.ShoppingLists;

// The following imports are required:
// using commercetools.Sdk.Api.Models.Categories;
// using commercetools.Sdk.Api.Models.Common;

// Create a LocalizedString
LocalizedString multiLanguageString = new LocalizedString(){
  {"en", "English value"},
  {"de", "German value"}
};

// Create US$100.00
Money money = new Money()
{
  CurrencyCode = "USD",
  CentAmount = 10000
};

// Create a Category
CategoryDraft categoryDraft = new CategoryDraft()
{
  Name = new LocalizedString() { { "en", "english name" } },
  Slug = new LocalizedString() { { "en", "english-slug" } },
  Key = "category-key"
};

var shoppingListInfo = projectApiRoot
  .ShoppingLists()
  // ...

// Get a specific Shopping List by ID
var shoppingListInfo = projectApiRoot
  .ShoppingLists()
  .WithId("a-shoppinglist-id")
  .Get()
  .ExecuteAsync()
  .Result;

// Get a specific Shopping List by key
var shoppingListInfo = projectApiRoot
  .ShoppingLists()
  .WithKey("a-shoppinglist-key")
  .Get()
  .ExecuteAsync()
  .Result;

// Return an IShoppingListPagedQueryResponse
var shoppingListsQuery = projectApiRoot
  .ShoppingLists()
  .Get()
  .ExecuteAsync()
  .Result;

// Return all Customers that have not verified their email address
var response = projectApiRoot
 .Customers()
 .Get()
 .WithQuery(c => c.IsEmailVerified().Is(false))
 .ExecuteAsync()
 .Result;

// Return an IShoppingListPagedQueryResponse
var shoppingListsQuery = projectApiRoot
  .ShoppingLists()
  .Get()
  .ExecuteAsync()
  .Result;

// Put the returned Shopping Lists in a list
var listOfShoppingLists = shoppingListsQuery.Results;

// Output the first Shopping List's English name
Console.WriteLine(listOfShoppingLists[0].Name["en"]);

// Build a ShoppingListDraft with the required fields (name)
var newShoppingListDetails = new ShoppingListDraft()
{
  Name = new LocalizedString() { { "en", "English name of Shopping List" } }
};

// Post the ShoppingListDraft and get the new Shopping List
var newShoppingList = projectApiRoot
  .ShoppingLists()
  .Post(newShoppingListDetails)
  .ExecuteAsync()
  .Result;

// Build a ShoppingListUpdate with the required fields (version and list of IShoppingListUpdateActions)
var shoppingListUpdate = new ShoppingListUpdate()
{
  Version = 1,
  Actions = new List<IShoppingListUpdateAction>
  {
    {
      new ShoppingListSetKeyAction(){Key="a-unique-shoppinglist-key"}
    }
  }
};

// Post the ShoppingListUpdate and return the updated Shopping List
var updatedShoppingList = projectApiRoot
  .ShoppingLists()
  .WithId("{shoppingListID}")
  .Post(shoppingListUpdate)
  .ExecuteAsync()
  .Result;

// Delete and return a Shopping List
var deletedShoppingList = projectApiRoot
  .ShoppingLists()
  .WithId("{shoppingListID}")
  .Delete()
  .WithVersion(1)
  .WithDataErasure(true) // Include to erase related personal data
  .ExecuteAsync()
  .Result;

var variables = new { productFilter = $@"id = ""{productId}""" };
var response = await client.Query(variables,
  static (i, o) => o.Products(where: i.productFilter,
      selector: r => new { results = r.Results(product => new { product.Id })}
  )
);

Assert.NotNull(response.Data?.results[0].Id);