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

共有連絡先の更新と削除は、どちらも連絡先の編集 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 クエリ パラメータを使用してリクエストします。

次のステップ

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