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

共有連絡先の更新と削除は、どちらも連絡先の編集 URL を使用するため、手順は似ています。

共有連絡先を更新する

エントリを更新する場合は、サーバーから取得した XML をすべて保持してください。 保持しないと、無視された要素は削除されます。更新内容がオートコンプリートと連絡先マネージャーに反映されるまでには、最大で 24 時間かかることがあります。

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

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

  3. 更新したエントリを含む PUT リクエストを、連絡先の編集 URL に送信します。 application/atom+xml コンテンツ タイプを使用し、<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: ドメイン（例: example.com）。
    • TITLE_NAME: エントリの名前（例: example.com の連絡先リスト）。
    • FIRST_NAME: 連絡先の名前。
    • LAST_NAME: 連絡先の姓。
    • PROJECTION: 投影の値。サポートされている値については、投影の値をご覧ください。
    • PRIMARY_PHONE_NUMBER: 優先する電話番号。
    • 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 クエリ パラメータを使用します。

次のステップ

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