Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Üç Yönlü Hesap Bağlantısı Gerçekleştirin
Hesap Bağlamayla İlgili Ek Kılavuz
Bir satıcı OAuth kapsamını kabul ettikten sonra, satıcı için bir erişim ve yenileme jetonu oluşturulur. MCA yenileme jetonu depolandıysa accounts.link ile bir AccountsLinkRequest nesnesi kullanılarak API isteği yapılabilir. İşlem "request" olmalıdır.
Buna karşılık, alt hesabın jetonu kullanıldıktan hemen sonra bir AccountsLinkRequest nesnesiyle API isteği gönderilebilir. İşlem türü "onaylandı" olmalıdır. Bu, platformunuza katılan satıcılarınız için basitleştirilmiş bir hesap bağlama iş akışı sağlar.
Üç Yönlü Hesap Bağlantısı Gerçekleştirin
Aşağıdaki örnek hesaplarınız olduğunu varsayalım:
Hesap
Amaç
111111111
MCA Hesabı
2222222
Diğer Alt Hesap
3333333
Yeni İlk Katılım Hesabı
BAĞLANTI İSTEĞİ için account.link kaynağında, parametrelerin değeri şu şekilde olur:
Parametre
Değer
merchantID
111111111
accountID
2222222
AccountLinkRequest gövdesi aşağıdaki özelliklere sahip olur:
Özellik
Değer
linkType
eCommercePlatform
linkedAccountId
3333333
işlem
istek
Buna karşılık LINK APPROVE için account.link kaynağında, parametrelerin değeri aşağıdaki gibi olur:
Parametre
Değer
merchantID
3333333
accountID
3333333
AccountLinkRequest gövdesi aşağıdaki özelliklere sahip olur:
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eaccounts.link\u003c/code\u003e API enables streamlined account linking for merchants joining your platform.\u003c/p\u003e\n"],["\u003cp\u003eA three-way account link involves an MCA account, a subaccount, and a new onboarding account.\u003c/p\u003e\n"],["\u003cp\u003eTo initiate a link request, use the MCA account's OAuth token and set the action to "request".\u003c/p\u003e\n"],["\u003cp\u003eTo approve a link request, use the subaccount's OAuth token, set the action to "approve", and provide an external account identifier.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eaccounts.link\u003c/code\u003e resource requires specific parameters and an \u003ccode\u003eAccountLinkRequest\u003c/code\u003e body with relevant properties for both request and approval actions.\u003c/p\u003e\n"]]],["A three-way account link involves using the `accounts.link` API. First, a request is made from the MCA account (e.g., 111111111) to link a subaccount (e.g., 2222222) to a new onboarding account (e.g., 3333333), with the `action` set to \"**request**\". Then, using the subaccount's token, another API request is made to approve the link, setting `action` to \"**approve**\". This specifies the `linkedAccountId`, along with services and external identifier.\n"],null,["Perform a Three-Way Account Link\n--------------------------------\n\n### Further Account Linking Guidance\n\n*** ** * ** ***\n\nOnce a merchant has accepted the OAuth scope, an access \\& refresh token is\ngenerated for the merchant. If the MCA refresh token has been stored, an API\nrequest can be made using [`accounts.link`](https://developers.google.com/shopping-content/reference/rest/v2.1/accounts/link) with an\n[`AccountsLinkRequest`](https://developers.google.com/shopping-content/reference/rest/v2.1/accounts/link#accountslinkrequest) object. The action should be \"**request**\".\n\nConversely, an API request then can be made immediately after *using the\nsubaccount's token* , with an AccountsLinkRequest object. The action type should\nbe \"**approved**\". This enables a streamlined account linking workflow for\nyour merchants joining your platform.\n| **Tip:** In the accounts.link API Request. There might be a case where you'd need to do a 3-way merchant link where a subaccount needs to be linked to another external account that is managing its inventory.\n\n### Perform a Three-Way Account Link\n\n*** ** * ** ***\n\nAssume you have the following example accounts:\n\n| Account | Purpose |\n|-----------|------------------------|\n| 111111111 | MCA Account |\n| 2222222 | Other Subaccount |\n| 3333333 | New Onboarding Account |\n\nThe account.link resource for **LINK REQUEST** would have the following for\nits parameters:\n\n| Parameter | Value |\n|------------|-----------|\n| merchantID | 111111111 |\n| accountID | 2222222 |\n\nAnd the **AccountLinkRequest body** would have the following properties:\n\n| Property | Value |\n|-----------------|-------------------|\n| linkType | eCommercePlatform |\n| linkedAccountId | 3333333 |\n| action | **request** |\n\n| **Important:** This request would be made using an API client that has the *MCA Account* OAuth Token.\n\nConversely, the account.link resource for **LINK APPROVE** would have the\nfollowing for its parameters:\n\n| Parameter | Value |\n|------------|---------|\n| merchantID | 3333333 |\n| accountID | 3333333 |\n\nAnd the **AccountLinkRequest body** would have the following properties:\n\n| Property | Value |\n|---------------------------------------------|---------------------------------------------|\n| linkType | eCommercePlatform |\n| linkedAccountId | 2222222 |\n| action | **approve** |\n| eCommercePlatformLinkInfo.externalAccountId | *your external identifier for the customer* |\n| services | shoppingAdsProductManagement |\n\n| **Important:** This request would be made using an API client that has the *Subaccount* OAuth Token."]]
