إنشاء الحسابات الفرعية وإدارتها

في Merchant API، يمكن أن تكون للحسابات علاقة حساب فرعي بحساب آخر. يمكنك استخدام Merchant Accounts API لإنشاء حسابات فرعية جديدة ضمن حسابك المتقدّم. يجب أن يكون لديك حساب متقدم حالي لإجراء هذه المكالمة. لا يمكنك استخدام Merchant API لنقل حسابات التجار المستقلة الحالية ضمن حسابك.

يمكن لمقدّمي الخدمات الخارجيين استخدام Merchant Accounts API لتطوير واجهة تتيح للتجّار إنشاء تفاصيل حساباتهم وإدارتها.

إنشاء حساب فرعي

لإنشاء حساب فرعي جديد ضمن حسابك المتقدّم، يُرجى الاتصال برقم accounts.createAndConfigure:

  1. قدِّم تفاصيل الحساب الفرعي في الحقل account.
  2. حدِّد أي مستخدمين مفوَّضين جدد في الحقل users. يتم أيضًا اكتساب إذن وصول المستخدم من الحساب الرئيسي.
  3. حدِّد accountAggregation في حقل service.

    في ما يلي مثال على إنشاء حساب فرعي ضمن الحساب 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

  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);
    }
  }

قبول بنود الخدمة

تكتسِب الحسابات الفرعية بنود خدمة Merchant Center (TOS) التي وقّع عليها الحساب الرئيسي.

تعديل معلومات نشاطك التجاري

يمكنك استخدام Merchant Accounts API لتعديل معلومات نشاطك التجاري.

  • للاطّلاع على معلومات نشاطك التجاري، يُرجى الاتصال على الرقم accounts.getBusinessInfo.
  • لتعديل معلومات نشاطك التجاري، يُرجى الاتصال بالرقم accounts.updateBusinessInfo.