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

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

共有の連絡先を更新する

エントリを更新する場合は、サーバーからエントリを取得したときに存在していた 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: 共有する連絡先の姓（例: 金）。
    • 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 は、連絡先の更新に使用した URL と同じです。

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

次のステップ

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