ربط ملف تجاري على Google

مجموعة مواقع جغرافية للنشاط التجاري على Google هي بمثابة مجلد مشترَك لمواقعك الجغرافية. تقدّم مجموعة المواقع الجغرافية للنشاط التجاري وسيلة آمنة لمشاركة إدارة مواقعك مع مستخدمين متعددين. لمزيد من المعلومات، يُرجى الاطّلاع على لمحة عن مجموعات الأنشطة التجارية.

قبل تحميل مستودعك المحلي، حدِّد مجموعة المواقع الجغرافية للنشاط التجاري التي سيكون حسابك على Merchant Center مسؤولاً عنها. يمكنك الحصول على قائمة بمجموعات المواقع الجغرافية المؤهّلة من "الملف التجاري" باستخدام Merchant API، ولكن للوصول إليها، عليك أولاً ربط حسابك بملف تجاري.

طلب إذن الوصول إلى ملف تجاري

للوصول إلى ملف تجاري، استخدِم gbpAccounts.LinkGbpAccount الطريقة التالية:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/<var>ACCOUNT_ID</var>/gbpAccounts:linkGbpAccount

{
  "gbpEmail": "[e-mail]",
}

غيِّر القيم في السلسلة على الشكل التالي:

• ACCOUNT_ID: المعرّف الفريد لحسابك على Merchant Center
• GBP_EMAIL: عنوان البريد الإلكتروني للمشرف على الملف التجاري

عند استدعاء هذه الطريقة، تُرسِل الخدمة رسالة إلكترونية إلى المشرف المحدَّد، تطلب منه قبول طلب الوصول أو رفضه. إذا لم يردّ المشرف في غضون 7 أيام، تنتهي صلاحية الطلب تلقائيًا.

إدراج مجموعات المواقع الجغرافية للنشاط التجاري المتاحة

بعد موافقة المشرف على الطلب، يمكنك التحقّق من مجموعات الأنشطة التجارية المتاحة باستخدام طريقة gbpAccounts.List.

في ما يلي نموذج طلب وردّ ناجح:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/<var>ACCOUNT_ID</var>/gbpAccounts

Response:
200 OK
{
  "gbpAccounts": [
    {
      "name": "accounts/<var>ACCOUNT</var>/gbpAccounts/12345",
      "gbpAccountId": 12345,
      "type": USER,
      "gbpAccountName": "[e-mail]",
      "listingCount": 15
    }, {
      "name": "accounts/<var>ACCOUNT</var>/gbpAccounts/67890",
      "gbpAccountId": 67890,
      "type": BUSINESS_ACCOUNT,
      "gbpAccountName": "Google My Business Account",
      "listingCount": 23
    }
  ],
  "nextPageToken": 50
}

يمكنك استخدام نموذج الرمز البرمجي هذا لاسترداد جميع مجموعات الأنشطة التجارية المؤهّلة:

package shopping.merchant.samples.accounts.v1beta;

// [START merchantapi_list_gbp_accounts]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1beta.AccountName;
import com.google.shopping.merchant.accounts.v1beta.GbpAccount;
import com.google.shopping.merchant.accounts.v1beta.GbpAccountsServiceClient;
import com.google.shopping.merchant.accounts.v1beta.GbpAccountsServiceClient.ListGbpAccountsPagedResponse;
import com.google.shopping.merchant.accounts.v1beta.GbpAccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1beta.ListGbpAccountsRequest;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 *   This class demonstrates how to get the list of GBP accounts for a given Merchant Center account
 */
public class ListGbpAccountsSample {

  public static void listGbpAccounts(Config config) throws Exception {

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

    // Creates service settings using the retrieved credentials.
    GbpAccountsServiceSettings gbpAccountsServiceSettings =
        GbpAccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    String accountId = config.getAccountId().toString();
    // Creates parent to identify the omnichannelSetting from which to list all Lfp Providers.
    String parent = AccountName.newBuilder().setAccount(accountId).build().toString();

    // Calls the API and catches and prints any network failures/errors.
    try (GbpAccountsServiceClient gbpAccountsServiceClient =
        GbpAccountsServiceClient.create(gbpAccountsServiceSettings)) {
      ListGbpAccountsRequest request =
          ListGbpAccountsRequest.newBuilder().setParent(parent).build();

      System.out.println("Sending list GBP accounts request:");
      ListGbpAccountsPagedResponse response = gbpAccountsServiceClient.listGbpAccounts(request);

      int count = 0;

      // Iterates over all the entries in the response.
      for (GbpAccount gbpAccount : response.iterateAll()) {
        System.out.println(gbpAccount);
        count++;
      }
      System.out.println(String.format("The following count of elements were returned: %d", count));
    } catch (Exception e) {
      System.out.println("An error has occurred: ");
      System.out.println(e);
    }
  }

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

    listGbpAccounts(config);
  }
}
// [END merchantapi_list_gbp_accounts]

تحديد مجموعة المواقع الجغرافية للنشاط التجاري في حساب Merchant Center

قائمة مجموعات المواقع الجغرافية للنشاط التجاري المتاحة، يمكنك ربط مجموعة المواقع الجغرافية للنشاط التجاري بحسابك على Merchant Center. على سبيل المثال، إذا أردت اختيار مجموعة ملف العمل التي تحمل رقم تعريف حساب GBP‏ 12345 (المعروض في الخطوة السابقة)، يمكنك استخدام AccountServices.proposeAccountService:

POST
https://merchantapi.googleapis.com/accounts/v1beta/accounts/<var>ACCOUNT_ID</var>/services:propose
{
  provider: "providers/GOOGLE_BUSINESS_PROFILE",
  account_service: {
    external_account_id: "12345",
    local_listing_management {}
  }
}

يُرجى العلم أنّ حقل provider يجب أن يكون providers/GOOGLE_BUSINESS_PROFILE. عليك ضبط حقل LocalListingManagement فارغ في الطلب.

إرسال بيانات المنتجات والمستودع

بعد ربط حسابك على Merchant Center بمجموعة مواقع جغرافية للنشاط التجاري، يمكنك تحميل بيانات منتجاتك ومستودعك داخل المتجر. لمزيد من المعلومات، اطلع على

• دليل إعداد برنامج "الشراكة في الخلاصات المحلية"
• Local Inventory API