拡張プロパティとプロジェクション

共有連絡先のカスタム特性を定義するには、拡張プロパティと投影を使用します。

拡張プロパティ

共有の連絡先エントリでは、任意の名前と値のペアを使用して、追加の共有連絡先関連情報を拡張プロパティとして設定できます。鍵の一意性はユーザーの責任で保持してください。拡張プロパティの値は、値（任意の文字列）または XML blob（書式なしテキスト）として保存できます。各共有連絡先には、最大 10 個の拡張プロパティを関連付けることができます。 各拡張プロパティは適切なサイズにする必要があり、写真や着信音は使用しないでください。

例

次の例は、キーと値を持つ拡張プロパティを示しています。

&lt;gd:extendedProperty name="com.google" value="<var>VALUE</var>"/&gt;

次の例は、キーと XML blob を使用する拡張プロパティを示しています。

&lt;gd:extendedProperty name="com.google"&gt;
  &lt;<var>XML_PARAMETER</var>&gt;&lt;/<var>XML_PARAMETER</var>&gt;
&lt;/gd:extendedProperty>

投影値

拡張プロパティの表示を制限するには、投影を使用します。拡張プロパティ（gd:extendedElement 要素）の設定は、full または property-KEY 投影内でのみ可能です。

次の表に、サポートされている投影値を示します。

プロジェクション名 説明
thin gd:extendedProperty 要素は返されず、更新もされません。
property-KEY KEY は、返される（GET リクエストの場合）または更新する必要がある拡張プロパティ（gd:extendedProperty 要素）のキー（PUT または POST リクエストの場合）を示します。拡張プロパティが更新オペレーションで使用されていない場合、そのプロパティは削除されます。
full すべての gd:extendedProperty 要素が返され、更新中にすべての要素が含まれている必要があります。