指定した日時まで公開

指定した日時まで公開する場合は publishBodyExpiresAt() メソッドを使います。下記は、ファイルを 2099 年 12 月 31 日まで公開したい場合のサンプルです。サンプルのように、日時は UNIX 時間（ミリ秒）で UTC（協定世界時）を用いて指定します。

// Assume that the KiiObject "object" has been instantiated.

// Set the expiration time of the URL.
Calendar calendar = Calendar.getInstance();
calendar.set(2099, Calendar.DECEMBER, 31, 23, 59, 59);
long time = calendar.getTimeInMillis();

try {
  // Publish the KiiObject.
  String publishUrl = object.publishBodyExpiresAt(time);
} catch (IOException e) {
  // Handle the error.
} catch (AppException e) {
  // Handle the error.
}

// Assume that the KiiObject "object" has been instantiated.

// Set the expiration time of the URL.
Calendar calendar = Calendar.getInstance();
calendar.set(2099, Calendar.DECEMBER, 31, 23, 59, 59);
long time = calendar.getTimeInMillis();

// Publish the KiiObject.
object.publishBodyExpiresAt(time, new KiiObjectPublishCallback() {
  @Override
  public void onPublishCompleted(String url, KiiObject object, Exception exception) {
    if (exception != null) {
      // Handle the error.
      return;
    }
  }
});

基本的な手順は下記のとおりです。

Object Body をアップロードします。
publishBodyExpiresAt() メソッドを呼びファイルを公開します。

なお、ファイルを公開するユーザーはこの KiiObject に対する READ_EXISTING_OBJECT アクションを許可されている必要があります（公開後の URL は、誰でも Web ブラウザから参照できます）。アクセス権限の詳細は KiiObject の ACL 設定を参照してください。