تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
الدمج مع "إعلانات Google"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح My Business Business Information API لمستخدمي AdWords API إنشاء المواقع الجغرافية وتعديلها في
"الملف التجاري على Google". ويمكن بعد ذلك مزامنة هذه المواقع الجغرافية مع "إعلانات Google" واستخدامها مع
إعلانات إضافات المواقع الجغرافية.
ولا يُشترط إثبات ملكية هذه المواقع الجغرافية لاستخدامها في "إعلانات Google"، ولكن قد لا تظهر أي تعديلات يتم إجراؤها بهذه الطريقة
على "خرائط Google" أو "بحث Google" ما لم يتم إثبات ملكية المواقع الجغرافية. لاستخدام تقارير "الشراء على الإنترنت أو في المتجر"، مثل زيارات المتجر،
يجب أن يكون لديك بطاقة بيانات "الملف التجاري على Google" تم إثبات ملكيتها وتكون مرتبطة بإضافات المواقع الجغرافية.
إدارة المواقع الجغرافية
لمزيد من المعلومات عن السياسات المتعلقة بإنشاء المواقع الجغرافية، يُرجى الرجوع إلى إرشادات تمثيل نشاطك التجاري على Google في "الملف التجاري على Google".
لا يحتاج المعلِنون الذين يحتاجون إلى المواقع الجغرافية فقط لعرض إعلانات إضافات المواقع الجغرافية إلى إثبات ملكية
مواقعهم الجغرافية في "الملف التجاري".
إعلانات Google
إذا كان لديك حساب واحد فقط على "الملف التجاري على Google"، يمكنك مزامنة هذا الحساب مع "إعلانات Google". إذا كان حساب "ملفّ تجاري على Google" يحتوي على عدد كبير من المواقع الجغرافية، ننصحك بربط المواقع الجغرافية بحملات أو مجموعات إعلانية فردية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة
فلترة إضافات المواقع الجغرافية.
إذا كان لدى عملائك حسابات على "الملف التجاري على Google"، أو إذا كنت تريد العمل مع
مواقعهم الجغرافية التي تم إثبات ملكيتها، اطلب من العميل دعوتك إلى حسابه الحالي على "الملف التجاري على Google" بصفتك
مديرًا. استخدِم بيانات الاعتماد الخاصة بك مع رقم تعريف حساب "الملف التجاري على Google" الخاص بعميلك عند
ربطه بحساب "إعلانات Google". لمزيد من المعلومات، اطّلِع على إنشاء عنصر PlacesLocationFeedData في الخلاصة.
إذا كنت مهتمًا فقط بخدمة "إعلانات Google" ولم تكن بحاجة إلى إثبات ملكية المواقع الجغرافية أو إدارتها في "خرائط Google" و"بحث Google"، يمكنك إنشاء حساب "ملف تجاري" واحد على مستوى الشريك يحتوي على جميع المواقع الجغرافية لنشاطك التجاري. استخدِم فلترة التصنيفات لربط المواقع الجغرافية في "الملف التجاري" بحملات معيّنة على "إعلانات Google". على الرغم من أنّه يمكنك استخدام أيّ معرّف مخصّص، ما دامت تتبّعه، يمكنك استخدام
رقم تعريف العميل في "إعلانات Google" كأحد
التصنيفات.
AdWords API
يمكن للشريك أو الوكالة إدارة إضافات المواقع الجغرافية من خلال خلاصة إضافات المواقع الجغرافية يدوية في AdWords API. إذا كان الأمر كذلك، يجب دمجها مع واجهة برمجة التطبيقات Business Information API في "نشاطي التجاري" أو استخدام واجهة مستخدم ملفالملف التجاري لإدارة إضافات المواقع الجغرافية.
تسمح واجهة برمجة التطبيقات Business Information API في "نشاطي التجاري" للجهات الخارجية بإنشاء مواقع جغرافية لم يتم إثبات ملكيتها، ثم استخدام واجهة برمجة التطبيقات AdWords API لربط حساباتهم على "الملف التجاري على Google" وعرض إضافات المواقع الجغرافية. لا يؤثّر استخدام
المواقع الجغرافية غير المؤكَّدة كبُنيَات إضافية للمواقع الجغرافية في "إعلانات Google" في ترتيب الإعلان.
استخدام التصنيفات
تتيح لك التصنيفات الإشارة إلى مواقع جغرافية فردية في الملف التجاري باستخدام سلاسل مخصّصة.
يهدف التصنيفات في المقام الأول إلى توفير طريقة لمستخدمي "إعلانات Google" لربط
مواقع "الملف التجاري على Google" بحملات معيّنة على "إعلانات Google".
على الرغم من أنّه يمكنك استخدام أي سلسلة، طالما أنّك تتتبّعها، يمكنك استخدام رقم تعريف العميل على "إعلانات Google" كعلامة. بعد مزامنة حساب "الملف التجاري" مع "إعلانات Google"، يمكنك
ربط رقم تعريف العميل في "إعلانات Google" بالموقع الجغرافي الصحيح في "الملف التجاري".
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe My Business Business Information API enables creation and updating of Business Profile locations for use with location extension ads in Google Ads.\u003c/p\u003e\n"],["\u003cp\u003eVerification is optional for using locations in ads, but necessary for online-to-offline reporting and visibility on Maps and Search.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers can sync their Business Profile account with Google Ads, potentially mapping locations to campaigns or ad groups for better management.\u003c/p\u003e\n"],["\u003cp\u003eFor Google Ads focus, a single, partner-level Business Profile account with label filtering can manage all business locations and link them to specific campaigns.\u003c/p\u003e\n"],["\u003cp\u003eThe My Business Business Information API allows third-party creation of unverified locations for use as Google Ads location extensions without impacting Ad Rank.\u003c/p\u003e\n"]]],["The My Business Business Information API enables the creation and updating of Business Profile locations, which can then be synced with Google Ads for location extension ads. While verification isn't mandatory for use in Ads, it's required for Maps or Search visibility and store visit reporting. Users can sync their Business Profile account with Google Ads, map locations to specific campaigns or ad groups, and utilize labels to link locations to specific campaigns. For those not needing verified locations, a single partner-level Business Profile account can be created.\n"],null,["# Integrate with Google Ads\n\nThe My Business Business Information API allows users of the AdWords API to create and update locations in\nBusiness Profile. These locations can then be synced to Google Ads and used with\n[location extension ads](https://support.google.com/adwords/answer/2404182).\n\nVerification isn't required to use these locations in Ads, but any edits made this way may not\nappear on Maps or Search unless the locations are verified. To use online-to-offline reporting such\nas [store visits](https://support.google.com/adwords/answer/6100636),\nyou must have a verified Business Profile listing tied to location extensions.\n\nManage locations\n----------------\n\nTo learn more about the policies on the creation of locations, refer to the Business Profile\n[Guidelines for representing your business on Google](https://support.google.com/business/answer/3038177).\n\nAdvertisers who only need locations to run location extension ads don't need to verify their\nlocations in Business Profile.\n\n### Google Ads\n\nIf you only have one Business Profile account, sync that account to Google Ads. If the\nBusiness Profile account contains a large number of locations, you might want to map locations to\nindividual campaigns or ad groups. To learn more, see\n[Filtering location extensions](/adwords/api/docs/guides/feed-services-locations#filtering_location_extensions).\n\nIf your clients already have Business Profile accounts, or if you want to work with their\nverified locations, have your client invite you to their existing Business Profile Account as a\nmanager. Use your credentials in conjunction with your client's Business Profile account ID when\nmapping to Google Ads. To learn more, see\n[Creating the PlacesLocationFeedData object on the feed](/adwords/api/docs/guides/feed-services-locations#creating_the_placeslocationfeeddata_object_on_the_feed).\n\nIf you're only interested in Google Ads and don't need to verify or manage locations in Maps and\nSearch, create a single, partner-level Business Profile account that contains all of your\nbusiness locations. Use label filtering to associate Business Profile locations with specific Ads\ncampaigns. While you can use any custom ID, as long as you keep track of it, one option is to use\nthe Google Ads customer ID as a\n[label](https://support.google.com/business/answer/3370250?&vid=1-635804417253618036-2454227408#labels).\n\n### AdWords API\n\nA partner or agency might manage their location extensions through the manual location extensions\nfeed of the AdWords API. If so, they must integrate with the My Business Business Information API or use the\nBusiness Profile UI to manage location extensions.\n\nThe My Business Business Information API allows third parties to create unverified locations and then use the\nAdWords API to link their Business Profile account and serve location extensions. The use of\nunverified locations as Google Ads location extensions doesn't affect Ad Rank.\n\nUse labels\n----------\n\n[Labels](https://support.google.com/business/answer/3370250?&vid=1-635804417253618036-2454227408#labels) allow you to tag individual Business Profile locations with custom strings.\nLabels are primarily intended to provide a way for Google Ads users to associate\nBusiness Profile locations with specific Ads campaigns.\n\nWhile you can use any string, as long as you keep track of it, one option is to use the Google\nAds customer ID as a label. Once the Business Profile account is synced with Google Ads, you can\nassociate the Google Ads customer ID with the right location in Business Profile."]]
