APIを使用すると、CARTOアカウントにファイルをアップロードしたり、現在のアップロード状況を確認したり、特定のアカウントでプロセスをインポートしたり削除したりすることができます。このAPIは、送信されたファイルの変換およびインポートを処理する一連のCARTOエンドポイントを対象とするいくつかのHTTP要求で構成されています。CARTOテーブルは、標準テーブルまたは同期テーブルとして分類できます。ServerTMコネクタを使用すると、ArcGISTMレイヤをデータセットにインポートできます。クイックスタートこの例では、コマンドラインツールのcURLを使います。curlとタイプしてマニュアルを御覧ください。ローカルファイルのアップロードdocumentationという名前のCARTOのアカウントと、prism_tour.csvというファイルがローカルにあって、そのファイルをアカウントにアップロードしたいと仮定します。この場合、以下の様なコマンドをターミナルウィンドウで実行してください。file=@/home/documentation/Documents/prism_tour.csv"https://documentation.carto.com/api/v1/imports/?api_key=3102343c42da0f1ffe6014594acea8b1c4e7fd64"api_keyの部分は、英数半角文字で構成されており、この場合、documentationアカウントに個別に指定された値です。このリクエストへの反応は、以下の様なフォーマットになり、インポートは成功したことになります。true}item_queue_id値は、インポートのプロセスを参照するための識別子となります。インポートのプロセスが始まると、それに関する情報は、「インポートプロセスの状態をチェック」のセクションで説明するように、インポートのエンドポイントにリクエストを送ることで得ることができます。リモートURLからのインポート仮にホスト名が、examplehost.comというサーバに、sample.csvというファイルがアップロードされているとします。このファイルからテーブルを作成するには、ターミナルウィンドウで以下のコマンドを実行します。'{"url":"https://examplehost.com/sample.csv"}'"https://documentation.cartodb.com/api/v1/imports/?api_key=3102343c42da0f1ffe6014594acea8b1c4e7fd64"`このリクエストに対する反応は、以下の様なフォーマットで、インポートが成功したことを知らせてくれます。接続するmydbという外部MySQLデータベースがあるとします。この例では、アドレスがmydbserver.comのサーバーにアクセスします。ユーザー名はmyuser、パスワードはmypassです。ターミナルウィンドウで次のコマンドを実行して、mytableという名前のリモートテーブルにCARTOデータセットを接続します。ArcGISTMレイヤをデータセットにインポートします。コンセプトは、例外と明記していない限り、APIの全てのエンドポイントについて同様です。AuthCARTOのアカウト内にあるデータを操作するには、パスワードとしてユニークな識別子を使って、事前に承認を取る必要があります。インポートAPIに関しては、APIキーとして知られる特別の識別子が使われますが、このAPIキーは、各ユーザーアカウントについて認証されていることを証明するもので、これを使うことでデータにアクセスすることができます。承認されたリクエストを実行するには、api_key=YOURAPIKEYをリクエストするURLに追加する必要があります。パラメタは、POSTパラメタとして渡すこともできます。api_keyを含むリクエストを送る際には、HTTPSを使うことを強く推薦します。エラーエラーは、標準のHTTPコードを使って報告され、以下の例のように、より詳しい情報がHTML形式でさらに報告されます。&lt;/body&gt;&lt;/html&gt;特定の場合に応じて、エラーに関する追加情報が提示されることがあります。既知のエラーコードと解決策の詳細については、インポートエラーを参照してください。標準テーブルCartoDBが受け付けるファイルフォーマットでデータをアップロードすると、標準のインポートプロセスを経て、データはCartoDBのテーブルとしてインポートされます。uploadローカルファイルをインポートする際、ファイルを指定したPOSTを実行する必要があります(以下にあるCURLをつかった実行例を参照して下さい)url一般公開されているリモートファイルをインポートする際のフルURLtype_guessingfalseに設定した場合、フィールドのデータタイプの推測を無効にします(ExcelとCSVファイルに関して)。デフォルトはtrue。quoted_field_guessingfalseに指定した場合、CSVファイルのフィールドで、ダブルクォートされているフィールドのデータタイプの推測を無効にします。デフォルトはtrue。content_guessingtrueに設定した場合、データ内容の推測を有効にし、その結果に基づくジオコーディングを有効にします。今のところ、国名によるジオコーディングだけが行えます。デフォルトはfalse。create_vistrueに設定した場合、データセットをインポートした後、自動的に地図を作成するように、そのインポートプロセスに対し、フラグを立てます。デフォルトはfalse。collision_strategy既存のテーブルと同じ名前のデータセットをインポートするときの動作を指定します。...)で名前が変更されます。skipを設定すると、一致する名前のテーブルはインポートされません。overwriteを設定すると、スキーマに互換性がある場合のみ、テーブルが一致する名前に置き換えられます。privacyインポートによって生成された1つまたは複数のテーブルのプライバシー設定を設定するために使用されます。create_visがtrueに設定されている場合、結果として得られる視覚化のプライバシー設定もこのパラメータによって決定されます。プライバシーは次のように設定できます:public生成されるテーブルとビジュアリゼーションは、だれでも見ることができます。privateアップロードした人のみ、生成されるテーブルとビジュアリゼーションを見ることができます。linkアップロードした人が共有したプライベートリンクを知っている人のみが、生成されるテーブルとビジュアリゼーションを見ることができます。table_name既に存在するテーブルを複製する際に使います。ファイルとURLからのインポートと混同して使わないで下さい。table_copytable_nameと同様、テーブルをコピーする際に内部的に使われます。table_idテーブルを移植する際の内部で使うID。