[Apache Shindig][お勉強][OpenSocial] メモ59 DataRequest.newFetchPersonRequestの第二引数で指定できる値

DataRequest.newFetchPersonRequestの第二引数は、

要求に渡す追加パラメータです

とさらっと書いてある。
ちなみに、0.8.1では未使用とのこと。

何を指定すればいいのかさっぱりわからなかったけど、
どうも、

opensocial.DataRequest.PeopleRequestFields

に定義されている値が指定できることが、やっとわかったよ。

このコードによると、

opensocial.DataRequest.PeopleRequestFields = {
  /**
   * An array of
   * 
   * opensocial.Person.Field
   * specifying what profile data to fetch
   * for each of the person objects. The server will always include
   * ID, NAME, and THUMBNAIL_URL.
   *
   * @member opensocial.DataRequest.PeopleRequestFields
   */
  PROFILE_DETAILS : 'profileDetail',

  /**
   * A sort order for the people objects; defaults to TOP_FRIENDS.
   * Possible values are defined by
   * SortOrder.
   *
   * @member opensocial.DataRequest.PeopleRequestFields
   */
  SORT_ORDER : 'sortOrder',

  /**
   * How to filter the people objects; defaults to ALL.
   * Possible values are defined by
   * FilterType.
   *
   * @member opensocial.DataRequest.PeopleRequestFields
   */
  FILTER : 'filter',

  /**
   * Additional options to be passed into the filter,
   * specified as a Map<String, Object>.
   *
   * @member opensocial.DataRequest.PeopleRequestFields
   */
  FILTER_OPTIONS: 'filterOptions',

  /**
   * When paginating, the index of the first item to fetch.
   * Specified as a Number.
   *
   * @member opensocial.DataRequest.PeopleRequestFields
   */
  FIRST : 'first',
  /**
   * The maximum number of items to fetch; defaults to 20. If set to a larger
   * number, a container may honor the request, or may limit the number to a
   * container-specified limit of at least 20.
   * Specified as a Number.
   *
   * @member opensocial.DataRequest.PeopleRequestFields
   */
  MAX : 'max',

  /**
   * A string or array of strings, specifying the app data keys to fetch for
   * each of the Person objects. This field may be used interchangeably with
   * the string 'appData'.  Pass the string '*' to fetch all app data keys.
   * @member opensocial.DataRequest.PeopleRequestFields
   */
  APP_DATA : 'appData',

  /**
   * How to escape app data returned from the server;
   * defaults to HTML_ESCAPE. Possible values are defined by
   * EscapeType.
   * This field may be used interchangeably with the string 'escapeType'.
   * @member opensocial.DataRequest.PeopleRequestFields
   */
   ESCAPE_TYPE : 'escapeType'
};

とのこと。

ふーん。

.