アドレスを登録／更新／削除する

Garoon APIドキュメント

アドレスを登録／更新／削除する

固定リンクがコピーされました

アドレスを登録する

固定リンクがコピーされました

追加するアドレスをリクエストのパラメーターとして受け取り、追加し、追加されたアドレス情報をレスポンスとして返すAPIです。

API名

固定リンクがコピーされました

AddressAddCards

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
add_card	address:AddressCardContainsFileType	1～無制限	追加するアドレス

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


<parameters>
  <add_card>
    <card book_id="1" id="dummy" version="dummy">
      <creator user_id="1" name="dummy" date="dummy"></creator>
      <subject>アドレス帳タイトル</subject>
      <personal_name><part>個人名</part></personal_name>
      <personal_reading><part>こじんめい</part></personal_reading>
    </card>
  </add_card>
</parameters>

レスポンス

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
card	address:CardType	0～無制限	追加されたアドレス

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


<returns>
  <card book_id="1" id="1" version="1281486678" xmlns:card="http://schemas.cybozu.co.jp/address/2008">
    <card:creator user_id="1" name="Administrator" date="2010-08-11T00:31:18Z" />
    <card:modifier user_id="1" name="Administrator" date="2010-08-11T00:31:18Z" />
    <card:subject>アドレス帳タイトル</card:subject>
    <card:personal_name>
      <card:part>個人名</card:part>
      <card:part></card:part>
    </card:personal_name>
    <card:personal_reading>
      <card:part>こじんめい</card:part>
      <card:part></card:part>
    </card:personal_reading>
  </card>
</returns>

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_UTIL_API_65009	アップロードするファイルのサイズが、Base64エンコード後で300MBより大きい場合

アドレスを更新する

固定リンクがコピーされました

変更するアドレスをリクエストのパラメーターとして受け取り、変更し、変更されたアドレス情報をレスポンスとして返すAPIです。

API名

固定リンクがコピーされました

AddressModifyCards

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
modify_card	address:AddressCardContainsFileType	1～無制限	変更するアドレス

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


<parameters>
  <modify_card>
    <card xmlns="" book_id="1" id="1" version="dummy">
      <creator user_id="1" name="dummy" date="dummy"></creator>
      <subject>アドレス帳タイトル - modified</subject>
      <personal_name><part>個人名-modified</part></personal_name>
      <personal_reading><part>こじんめい-modified</part></personal_reading>
    </card>
  </modify_card>
</parameters>

レスポンス

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
card	address:CardType	0～無制限	変更されたアドレス

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


<returns>
  <card book_id="1" id="1" version="1281487669"
   xmlns:card="http://schemas.cybozu.co.jp/address/2008">
    <card:creator user_id="1" name="Administrator" date="2010-08-11T00:31:18Z" />
    <card:modifier user_id="1" name="Administrator" date="2010-08-11T00:47:49Z" />
    <card:subject>アドレス帳タイトル - modified</card:subject>
    <card:personal_name>
      <card:part>個人名-modified</card:part>
      <card:part></card:part>
    </card:personal_name>
    <card:personal_reading>
      <card:part>こじんめい-modified</card:part>
      <card:part></card:part>
    </card:personal_reading>
  </card> 
</returns>

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_UTIL_API_65009	アップロードするファイルのサイズが、Base64エンコード後で300MBより大きい場合

共有アドレス帳のアドレスを削除する

固定リンクがコピーされました

共有アドレス帳のIDと削除するアドレスのIDをリクエストのパラメーターとして受け取り、共有アドレス帳からアドレスを削除するAPIです。

API名

固定リンクがコピーされました

AddressRemoveSharedCards

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
@book_id	base:IDType	1	共有アドレス帳のID
card_id/text()	base:IDType	1～無制限	削除するアドレスのID

例

1
2
3


<parameters book_id="1">
  <card_id>1</card_id>
</parameters>

レスポンス

固定リンクがコピーされました

なし

個人アドレス帳のアドレスを削除する

固定リンクがコピーされました

削除するアドレスのIDをリクエストのパラメーターとして受け取り、削除するAPIです。

API名

固定リンクがコピーされました

AddressRemovePersonalCards

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
card_id/text()	base:IDType	1～無制限	削除するアドレスのID

例

1
2
3


<parameters>
  <card_id>1</card_id>
</parameters>

レスポンス

固定リンクがコピーされました

なし

アドレスを移動する

固定リンクがコピーされました

移動するアドレス情報をリクエストのパラメーターとして受け取り、移動処理を実行後、移動したアドレス情報をレスポンスとして返すAPIです。閲覧できないbook_idを指定した場合、空のレスポンスが返されます。

API名

固定リンクがコピーされました

AddressCopyPersonalCardsToOtherBook

使用可能なGaroonのバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
copy_item	address:AdressConpyItemType	1～無制限	移動するアドレス情報

例

1
2
3


<parameters>
  <copy_item copied_book_id="1" card_id="2"></copy_item>
</parameters>

レスポンス

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
card	address:CardType	0～無制限	移動したアドレス情報

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


<returns>
  <card book_id="1" id="3" version="1281489220" xmlns:card="http://schemas.cybozu.co.jp/address/2008">
    <card:creator user_id="1" name="Administrator"  date="2010-08-11T01:13:40Z" />
    <card:modifier user_id="1" name="Administrator" date="2010-08-11T01:13:40Z" />
    <card:subject>こじんあどれす</card:subject>
    <card:personal_name>
      <card:part>伊藤</card:part>
      <card:part>太郎</card:part>
    </card:personal_name>
    <card:personal_reading>
      <card:part>いとう</card:part>
      <card:part>たろう</card:part>
    </card:personal_reading>
  </card>
</returns>

Garoon APIドキュメント