# 各エンドポイントで指定するパラメーターについて

**URL:** <https://community.hubspot.com/t/topic/60504>\
**Category:** Tips, Tricks & Best Practices\
**Tags:** professional\
**Created:** [July 7, 2022, 8:09am UTC](https://community.hubspot.com/t/topic/60504 "2022-07-07T08:09:01Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![nakamura2](https://avatars.discourse-cdn.com/v4/letter/n/d2c977/32.png) [@nakamura2](https://community.hubspot.com/u/nakamura2)\
**Post date:** [July 7, 2022, 8:09am UTC](https://community.hubspot.com/t/topic/60504/1 "2022-07-07T08:09:01Z")

</div>

以下APIエンドポイントを利用することで、特定のメールアドレスのサブスクリプションタイプのステータスを自動変更したいと考えております。

自動変更の実現可能性を確認したく、本エンドポイントで指定する以下パラメーターについて、ご存知の方、教えていただけませんでしょうか？＞＜

どうぞよろしくお願い致します。

---------------------------------------------------------------------------------------

▼APIエンドポイント

[配信設定v3 - HubSpot docs](https://developers.hubspot.jp/docs/api/marketing-api/subscriptions-preferences)

▼パラメーター

・subscriptionId

HubSpot上のどの項目のIDを指定するか

・legalBasis

各選択肢による挙動の違い

---

<div class="post-metadata">

**Author:** ![KMurota](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/kmurota/32/61991_2.png) [@KMurota](https://community.hubspot.com/u/KMurota)\
**Post date:** [July 7, 2022, 9:17am UTC](https://community.hubspot.com/t/topic/60504/2 "2022-07-07T09:17:52Z")

</div>

@nakamura2  
GDPRについて詳しくはないのですが、APIを散々叩いているので回答させていただきます。  
GETで  
[https://api.hubapi.com/communication-preferences/v3/status/email/{emailAddress}](https://api.hubapi.com/communication-preferences/v3/status/email/%7BemailAddress%7D)  
または  
[https://api.hubapi.com/communication-preferences/v3/definitions](https://api.hubapi.com/communication-preferences/v3/definitions)  
のエンドポイントを叩いたリターンのプロパティ名"id"の部分でIDが確認できます。

 ![KMurota_0-1657184755506.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/c/b/cb2da04ef61c347311048a4751dd98c4b4c6096c.png)

または設定→ツール→マーケティング→Eメールといくとございますが、UIではIDまでは確認できないようです。  
GDPRについては、以下の記事を参考にした限りですが、

> **[HubSpotアカウントでデータプライバシー設定を管理する](https://knowledge.hubspot.com/ja/privacy-and-consent/how-do-i-turn-on-gdpr-functionality-in-my-hubspot-account)**
>
> HubSpotアカウントのデータプライバシー設定を管理して、データのプライバシーに関する順守を徹底します。設定を有効化、調整、および無効化する方法をご確認ください。

[https://knowledge.hubspot.com/jp/contacts/how-can-i-track-lawful-basis-of-processing-in-hubspothttps://knowledge.hubspot.com/jp/contacts/how-do-subscription-preferences-and-types-work](https://knowledge.hubspot.com/jp/contacts/how-can-i-track-lawful-basis-of-processing-in-hubspothttps://knowledge.hubspot.com/jp/contacts/how-do-subscription-preferences-and-types-work)  
GDPR、配信設定などは、後で何かあった際の法的根拠・同意を追跡/設定するためのもので、

- GDPR有効がオンになっていると、サブスクタイプとその同意=Onのないコンタクトにメール配信できなくなります。
- legalbasisについては、基本的にはフォームまたは配信していいかどうか伺う配信で回収するものですが、手動またはAPIで更新するときに御社がどういうコミュニケーションに基づいてそのコンタクトの配信を設定する定義になるのか、法務の方と相談して特定いただくものかと存じます。

つまり、挙動に変わりはあるかと言われると、オンになっている＆有効なサブスクタイプが設定されている限り、変わらないはずです。  
@natsumimori さん、上記理解で合ってますでしょうか？？

---

<div class="post-metadata">

**Author:** ![nakamura2](https://avatars.discourse-cdn.com/v4/letter/n/d2c977/32.png) [@nakamura2](https://community.hubspot.com/u/nakamura2)\
**Post date:** [July 12, 2022, 6:25am UTC](https://community.hubspot.com/t/topic/60504/3 "2022-07-12T06:25:22Z")

</div>

@KMurota さん、

ご回答ありがとうございます！  
以下だと認識しましたm( )m

また何かございましたら回答いただければ幸いです。  
引き続きどうぞよろしくお願い致します。

-----------------------------------------------------------------  
▼subscriptionId  
⇒・サブスクリプションタイプに付与されている  
・画面上で確認することはできない  
・GET [https://api.hubapi.com/communication-preferences/v3/status/email/{emailAddress}](https://api.hubapi.com/communication-preferences/v3/status/email/%7BemailAddress%7D%E3%81%A7%E5%8F%96%E5%BE%97%E3%81%A7%E3%81%8D%E3%82%8B)

で取得できる

▼legalBasis  
⇒・法的根拠・同意を追跡/設定するためのもの  
・GDPR有効がオンになっており、有効なサブスクタイプが設定されている限り、  
選択肢によって挙動が変わることはない
