共有の連絡先を更新または削除する

共有の連絡先を更新または削除する場合のプロセスも同様です。

共有の連絡先を更新する

エントリを更新するときは、サーバーからエントリを取得したときに存在していた XML をすべて保持する必要があります。それ以外の場合は、無視された要素が削除されます。メールアドレスのオートコンプリートと連絡先管理ツールに更新が反映されるまでには、最長で 24 時間ほどかかることがあります。

既存の共有連絡先を更新する方法は次のとおりです。

  1. 更新するエントリを取得します。
  2. エントリを編集します。

  3. メッセージ本文のエントリを更新した PUT リクエストを連絡先の編集 URL に送信します。application/atom+xml コンテンツ タイプを使用して、更新したエントリの <id> 値が既存のエントリの <id> と完全に一致することを確認します。異なるソースからの更新の競合を検出するために、編集 URL の末尾にはバージョン番号が表示されます。詳細については、バージョニングをご覧ください。

    エントリを更新します。

    <entry>
  <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
  <updated>2008-02-28T18:47:02.303Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>TITLE_NAME</title>
  <gd:name>
    <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
  </gd:name>
  <content type='text'>NOTES</content>
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
  <link rel='edit' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
    primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
  <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
</entry>

    以下を置き換えます。

    • DOMAIN: ドメインの URL（例: example.com）。
    • TITLE_NAME: 連絡先エントリの名前（例: example.com 連絡先リスト）。
    • FIRST_NAME: 共有連絡先の名（例: Alex）。
    • LAST_NAME: 共有連絡先の姓（例: Kim）。
    • PROJECTION: gd:extendedProperty 要素を指定する投影値。サポートされている値の一覧については、投影の値をご覧ください。
    • PRIMARY_PHONE_NUMBER: 共有連絡先の優先電話番号（例: (206)555-1212）。
    • CUSTOM_PROPERTY: 共有の連絡先について保存するカスタム プロパティの名前（ペットなど）。

    • CUSTOM_PROPRTY_VALUE: 共有の連絡先について保存するカスタム プロパティの値（ハムスターなど）。

      以下は、編集 URL がハイライト表示された共有連絡先の更新済みエントリの例です。

      <entry>
<id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
<updated>2008-02-28T18:47:02.303Z</updated>
<category scheme='http://schemas.google.com/g/2005#kind'
  term='http://schemas.google.com/contact/2008#contact' />
<title type='text'>Fitzgerald</title>
<gd:name>
  <gd:fullName>Fitzgerald</gd:fullName>
</gd:name>
<content type='text'>Notes</content>
<link rel='self' type='application/atom+xml'
  href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
<link rel='edit' type='application/atom+xml'
  href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
<gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
  primary='true'>456-123-2133</gd:phoneNumber>
<gd:extendedProperty name="pet" value="hamster" />
<gd:extendedProperty name="cuisine">
  <italian />
</gd:extendedProperty>
</entry>

共有の連絡先を削除する

削除された共有連絡先がメールアドレスのオートコンプリートと連絡先管理ツールに表示されるまでには、最長で 24 時間ほどかかることがあります。既存の連絡先を更新するには、連絡先の更新をご覧ください。連絡先を削除してから再度追加して、連絡先を更新しないでください。

  • 共有の連絡先を削除するには、連絡先の編集 URL に DELETE リクエストを送信します。これは、連絡先の更新に使用したのと同じ URL です。

削除された連絡先のプレースホルダは、削除後 30 日間保持されます。その間に、showdeleted クエリ パラメータを使用してプレースホルダをリクエストできます。

次のステップ

共有連絡先の写真を更新または削除する