उप-खाते बनाना और मैनेज करना

Merchant API में, ऐडवांस खातों का किसी दूसरे खाते के साथ उप-खाता संबंध हो सकता है. उप-खातों की मदद से, उन कारोबारों को अपने एक से ज़्यादा सेलर और बड़े पैमाने पर मौजूद डोमेन मैनेज करने में मदद मिलती है जो एक से ज़्यादा देशों में कारोबार करते हैं. ऐडवांस खाते की ज़रूरी शर्तें पूरी करने वाले कारोबारों के बारे में जानने के लिए, ऐसी कंपनियां जो ऐडवांस खाते की सेटिंग ऐक्सेस करने की ज़रूरी शर्तें पूरी करती हैं लेख पढ़ें.

Merchant Center खाते के तहत नए उप-खाते बनाने के लिए, Merchant Center खाते के एपीआई का इस्तेमाल किया जा सकता है. यह कॉल करने के लिए, आपके पास पहले से कोई बेहतर खाता होना चाहिए. Merchant API का इस्तेमाल करके, कारोबारी या कंपनी के मौजूदा स्टैंडअलोन खातों को अपने खाते में ट्रांसफ़र नहीं किया जा सकता.

अपने Merchant Center खाते को ऐडवांस खाते में बदलने के लिए, आपके पास खाते का एडमिन ऐक्सेस होना चाहिए. आपको यह भी पक्का करना होगा कि आपके खाते में कोई समस्या बाकी न हो. ऐडवांस खाता पाने का तरीका जानने के लिए, ऐडवांस खाता सेटअप करने का अनुरोध करना लेख पढ़ें.

तीसरे पक्ष की सेवा देने वाली कंपनियां, Merchant Center खाते के एपीआई का इस्तेमाल करके ऐसा इंटरफ़ेस बना सकती हैं जिसकी मदद से व्यापारी/कंपनी/कारोबारी अपने खाते की जानकारी बनाएं और मैनेज कर सकें.

उप-खाता बनाना

अपने बेहतर खाते में नया उप-खाता बनाने के लिए, accounts.createAndConfigure को कॉल करें:

1. account फ़ील्ड में, सब-खाते की जानकारी दें.
2. users फ़ील्ड में, अनुमति वाले नए उपयोगकर्ताओं की जानकारी दें. उपयोगकर्ता का ऐक्सेस भी पैरंट खाते से इनहेरिट किया जाता है.

3. service फ़ील्ड में accountAggregation डालें.

   खाते account/123 के तहत सब-खाता बनाने का उदाहरण यहां दिया गया है. यह सब-खाते के लिए एग्रीगेटर है:

   POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure
   
   {
     "account": {
       "accountName": "merchantStore",
       "adultContent": false,
       "testAccount": false,
       "timeZone": {
         "id": "America/New_York",
       }
       "languageCode": "en-US",
     },
     "service": [
       {
         "accountAggregation": {},
         "provider": "providers/123"
       }
     ]
   }
   

यहां दिए गए सैंपल में, नया सब-खाता बनाने के लिए, CreateAndConfigureAccountRequest पैकेज का इस्तेमाल करने का तरीका बताया गया है.

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1beta.Account;
import com.google.shopping.merchant.accounts.v1beta.AccountAggregation;
import com.google.shopping.merchant.accounts.v1beta.AccountsServiceClient;
import com.google.shopping.merchant.accounts.v1beta.AccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1beta.CreateAndConfigureAccountRequest;
import com.google.shopping.merchant.accounts.v1beta.CreateAndConfigureAccountRequest.AddAccountService;
import com.google.type.TimeZone;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to create a sub-account under an MCA account. */
public class CreateSubAccountSample {

  private static String getParent(String accountId) {
    return String.format("accounts/%s", accountId);
  }

  public static void createSubAccount(Config config) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    AccountsServiceSettings accountsServiceSettings =
        AccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates parent/provider to identify the MCA account into which to insert the subaccount.
    String parent = getParent(config.getAccountId().toString());

    // Calls the API and catches and prints any network failures/errors.
    try (AccountsServiceClient accountsServiceClient =
        AccountsServiceClient.create(accountsServiceSettings)) {

      CreateAndConfigureAccountRequest request =
          CreateAndConfigureAccountRequest.newBuilder()
              .setAccount(
                  Account.newBuilder()
                      .setAccountName("Demo Business")
                      .setAdultContent(false)
                      .setTimeZone(TimeZone.newBuilder().setId("America/New_York").build())
                      .setLanguageCode("en-US")
                      .build())
              .addService(
                  AddAccountService.newBuilder()
                      .setProvider(parent)
                      .setAccountAggregation(AccountAggregation.getDefaultInstance())
                      .build())
              .build();

      System.out.println("Sending Create SubAccount request");
      Account response = accountsServiceClient.createAndConfigureAccount(request);
      System.out.println("Inserted Account Name below");
      // Format: `accounts/{account}
      System.out.println(response.getName());
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    createSubAccount(config);
  }
}
CreateSubAccountSample.java

उप-खाते वापस पाना

किसी एक से ज़्यादा क्लाइंट वाले खाते के सभी उप-खातों की सूची देखने के लिए, accounts.listSubaccounts तरीका अपनाएं.

अनुरोध का सैंपल यहां दिया गया है:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}:listSubaccounts

यहां किसी कॉल के सही तरीके से पूरा होने पर मिलने वाले जवाब का सैंपल दिया गया है:

{
  "accounts": [
    {
      "name": "accounts/{ACCOUNT_ID}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    },
    {
      "name": "accounts/{ACCOUNT_ID}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

ध्यान दें: किसी उप-खाते की जानकारी पाने के लिए किए गए accounts.get अनुरोध में, पैरंट Merchant Center खाते की जानकारी शामिल नहीं होती.

किसी उप-खाते को मिटाना

किसी उप-खाते को मिटाने के लिए, accounts.delete तरीका अपनाएं. इस तरीके को लागू करने के लिए, आपके पास एडमिन ऐक्सेस होना चाहिए.

अनुरोध का सैंपल यहां दिया गया है:

DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}

अगर एपीआई सही से जुड़ जाता है, तो रिस्पॉन्स बॉडी में खाली JSON ऑब्जेक्ट होता है.

सेवा की शर्तें स्वीकार करना

उप-खातों पर, Merchant Center की सेवा की शर्तें (एसटीओ) लागू होती हैं. इन शर्तों पर पैरंट खाते ने हस्ताक्षर किए होते हैं.

अपने कारोबार की जानकारी अपडेट करना

कारोबार की जानकारी में बदलाव करने के लिए, Merchant Center API का इस्तेमाल किया जा सकता है.

• अपने कारोबार की जानकारी देखने के लिए, accounts.getBusinessInfo पर कॉल करें.
• अपने कारोबार की जानकारी में बदलाव करने के लिए, accounts.updateBusinessInfo पर कॉल करें.