このページは Cloud Translation API によって翻訳されました。

販売パートナー向け .NET クイックスタート

このクイックスタートガイドの手順に沿って操作してください。10 分ほどでゼロタッチ登録へのリクエストを行うシンプルな .NET C# コンソールアプリ Reseller API。

前提条件

このクイックスタートを実行するには、次のものが必要です。

Google アカウント（ゼロタッチ登録販売パートナーのメンバー）あります。まだオンボーディングしていない場合は、販売パートナーポータルガイドをご覧ください。
Visual Studio 2013 以降。
インターネットアクセスとウェブブラウザ。

ステップ 1: ゼロタッチ登録 API を有効にする

こちらのウィザードを使用して、Google Developers Console でプロジェクトを作成または選択し、 API が自動的に有効になります。[続行]、[認証情報に進む] の順にクリックします。
[What data will you be access?] を [Application data] に設定します。
[次へ] をクリックします。サービスアカウントの作成を求めるメッセージが表示されます。
[サービスアカウント名] にわかりやすい名前を付けます。
この後の作業で使用するため、サービスアカウント ID（メールアドレスのようなもの）を控えておきましょう。後で使用します。
[ロール] を [サービスアカウント] > [サービスアカウントユーザー] に設定します。
[完了] をクリックして、サービスアカウントの作成を完了します。
作成したサービスアカウントのメールアドレスをクリックします。
[**鍵**] をクリックします。
[**鍵を追加**] をクリックし、[**新しい鍵を作成**] をクリックします。
[キーのタイプ] で [JSON] を選択します。
[作成] をクリックすると、秘密鍵がパソコンにダウンロードされます。
[**閉じる**] をクリックします。
ファイルを作業ディレクトリに移動し、名前を service_account_key.json に変更します。

ステップ 2: サービスアカウントをリンクする

ゼロタッチ登録ポータルを開きます。ログインが必要となる場合があります。
[ サービス] をクリックします。。
[サービスアカウントをリンク] をクリックします。
[メールアドレス] に、作成したサービスアカウントのメールアドレスを設定します。
[サービスアカウントをリンク] をクリックして、ゼロタッチでサービスアカウントを使用します。。

ステップ 3: プロジェクトを準備する

Visual Studio で新しい .NET Core C# コンソールアプリケーション プロジェクトを作成します。
パッケージマネージャーを開き、パッケージソース nuget.org を選択し、次のパッケージを追加します。
- Google.Apis.AndroidProvisioningPartner.v1
- Google.Apis.Auth

詳しくは、Microsoft のドキュメント「パッケージ。

ステップ 4: サンプルをセットアップする

ステップ 1 でダウンロードした service_account_key.json をビジュアルにドラッグします Studio ソリューションエクスプローラーです。
[service_account_key.json] を選択し、[プロパティ] ウィンドウに移動して [Copy to output directory] フィールドを [Always copy] に設定します。
Program.cs の内容を次のコードに置き換えます。
PartnerId（アプリの最初の行）の値として、独自の販売パートナー ID を挿入します。

using Google.Apis.AndroidProvisioningPartner.v1;
using Google.Apis.AndroidProvisioningPartner.v1.Data;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using System;
using System.Collections.Generic;
using System.IO;

namespace ZeroTouchResellerQuickstart
{
    class Program
    {
        // TODO: replace this with your partner reseller ID.
        static long PartnerId = 11036885;

        // Use a single scope for the all methods in the reseller API.
        static readonly string[] Scopes =
        { "https://www.googleapis.com/auth/androidworkprovisioning" };
        static string ApplicationName = "Zero-touch Reseller .NET Quickstart";

        static void Main(string[] args)
        {
            // Create a credential to authorize API requests using a service account key.
            // The service account must be linked using the zero-touch portal.
            ServiceAccountCredential credential;
            using (var stream =
                new FileStream("service_account_key.json", FileMode.Open, FileAccess.Read))
            {
                credential = GoogleCredential.FromStream(stream)
                                     .CreateScoped(Scopes)
                                     .UnderlyingCredential as ServiceAccountCredential;
            }

            // Create a zero-touch enrollment API service endpoint.
            var service = new AndroidProvisioningPartnerService(new BaseClientService.Initializer
            {
                HttpClientInitializer = credential,
                ApplicationName = ApplicationName
            });

            // Send an API request to list all our customers.
            PartnersResource.CustomersResource.ListRequest request =
                service.Partners.Customers.List(PartnerId);
            ListCustomersResponse response = request.Execute();

            // Print out the details of each customer.
            IList<Company> customers = response.Customers;
            if (customers != null)
            {
                foreach (Company customer in customers)
                {
                    Console.WriteLine("Name:{0}  ID:{1}",
                                      customer.CompanyName,
                                      customer.CompanyId);
                }
            }
            else
            {
                Console.WriteLine("No customers found");
            }
        }
    }
}

パートナー ID

API 呼び出しでは通常、引数として販売パートナー ID が必要です。ゼロタッチ登録ポータルでパートナー ID を確認する手順は次のとおりです。

ポータルを開きます。ログインが必要となる場合があります。
[ サービス] をクリックします。。
[販売パートナー ID] 行からパートナー ID 番号をコピーします。

ステップ 5: サンプルを実行する

サンプルをビルドして実行するには、Visual Studio ツールバーの [開始] をクリックします。

トラブルシューティング

クイックスタートの問題があればお知らせください。サポートさせていただきます。修正しますゼロタッチでサービスアカウントを使用して API 呼び出しを承認する方法については、認可をご覧ください。