في كل خلاصة، أدرِج
بيانات وصفية تُعلِم Google بكيفية تفسيرها.
يتم وصف تنسيق الخلاصات باستخدام
بنية بروتوكول 3، ولكن يمكنك تحميل خلاصاتك
بتنسيق JSON المقابل.
يُرجى الرجوع إلى عيّنات الخلاصات للاطّلاع على تنسيق JSON.
ننصحك بتحميل الخلاصات بتنسيق JSON.
حجم ملف الخلاصة وتقسيمها وضغطها
يُرجى الاطّلاع على الأدلة التعليمية التالية المتعلّقة بالضغط والشظايا:
لتحديد حجم الخلاصات، استخدِم الإرشادات التالية (يمكن أن تتألف الخلاصة
من ملفات متعددة تُعرف باسم "شرائح"):
تقسيم الخلاصة المقترَح:
خلاصة التجّار: شريحة واحدة
خلاصة الخدمات: شريحة واحدة
حجم ملفات الخلاصة وتقسيمها:
يجب أن يكون حجم ملف الشريحة أقل من 200 ميغابايت (بعد الضغط). استخدِم
شرائح متعددة إذا لزم الأمر.
لا يلزم إرسال السجلات الفردية المُرسَلة في شريحة واحدة في
الشريحة نفسها في الخلاصات المستقبلية.
للحصول على أداء أفضل، قسِّم البيانات بالتساوي بين الأجزاء، لجعل
حجم جميع ملفات الأجزاء متشابهًا.
استخدِم gzip لضغط خلاصات JSON النصية العادية إذا لزم الأمر. ومع ذلك، يجب
إجراء ذلك لكل جزء فردي من الخلاصة.
تحميل الخلاصات إلى خادم بروتوكول النقل الآمن للملفات (SFTP)
حمِّل خلاصاتك إلى بيئة وضع الحماية. ولإجراء ذلك، يُرجى الرجوع إلى ملف تعريف
أسماء المستخدمين ضمن
صفحة إعداد خلاصة "بوابة الشركاء". يتوفّر خادم بروتوكول النقل الآمن للملفات (SFTP) في Google
على العنوان sftp://partnerupload.google.com على المنفذ
19321.
ننصحك بمنح أسماء فريدة للملفات التي تحمّلها. على سبيل المثال،
قد يكون من المفيد إلحاق طابع زمني بكل اسم ملف. يساعد ذلك في
تحديد المشاكل وحلّها والاطّلاع على حالة الخلاصة.
التأكّد من صحة بياناتك
سجِّل الدخول إلى "بوابة الشركاء". انتقِل إلى بيئة وضع الحماية للعثور على الصفحات التالية في قسم لوحات البيانات.
تعرض إحصاءات ملخّص الخلاصة وتشير إلى الأخطاء أثناءتحميل
الخلاصة.
للتأكّد من صحة بياناتك بعد التحميل الأوّلي إلى
بيئة الاختبار التجريبي، تحقّق من
صفحة الخلاصات
بحثًا عن أي أخطاء في الخلاصة.
بعد ذلك، تحقّق من صفحة ملخّص المستودع بحثًا عن أي مشاكل في البيانات.
تشمل المشاكل الشائعة تحميل بيانات التجّار بدون أي خدمات أو تحميل خدمات
بدون أي خانات توفّر في المستقبل.
تعرِض واجهة مستودع التطبيقات الرملية، التي تحاكي تجربة واجهة المستخدم المباشرة، كيف ستبدو data من منظور المستخدم. للوصول إلى هذه الميزة، تأكَّد من أنّه تم ضبط مبدّل البيئات في أعلى الصفحة على Sandbox، ثم انتقِل إلى
المستودع > المستودع
، وابحث عن تاجر يكون إما "جاهزًا" أو "معروضًا (في Sandbox)"، ثم انقر على الرابط
في العمود الأيمن (إذا كان متاحًا) أو انقر على الصف وانقر على رابط RwG - E2E. إذا
لم يكن هناك تاجر لديه الحالة "جاهز" أو "معروض (في الوضع التجريبي)"، افتح حساب تاجر غير مفعّل وتأكَّد
من حلّ جميع المشاكل المدرَجة على يسار الصفحة (مثل التأكّد من تحميل معلومات مدى التوفّر في المستقبل).
إذا لم تتمكّن من الوصول إلى واجهة مستودع التطبيقات الاختبارية، تأكَّد من تسجيل الدخول
باستخدام حساب تم منحه إذن الوصول إلى الواجهة. تأكَّد أيضًا من أنّه
هذا هو الحساب الوحيد الذي سجّلت الدخول إليه. إذا سجّلت الدخول باستخدام حساب
مختلف ثم استخدمت ميزة "تبديل المستخدم" لتسجيل الدخول إلى
حساب Google الموافَق عليه، سيظلّ حسابك محظورًا من الوصول إلى واجهة مستخدِم مساحة المحاكاة.
تحميل خلاصاتك إلى قناة الإصدار العلني
بعد أن تتمكّن من تحميل خلاصات كاملة وخالية من الأخطاء بشكلٍ منتظم إلى
بيئة الاختبار التجريبي، يمكنك البدء في التحميل إلى بيئة الإنتاج.
في هذه المرحلة، لن يكون الدمج نشطًا.
يُرجى تحميل خلاصة التجار الكاملة في أقرب وقت ممكن (قبل بدء الإطلاق بأحد
أسابيع على الأقل)، حتى تتمكّن من بدء مطابقة التجّار مع بيانات نشاط تجاري على
Google. يُرجى التأكّد من صحة المطابقة.
بعد تحميل جميع بيانات خلاصة الإصدار العلني بشكلٍ منتظم
وربطها بنظام الإصدار العلني، تصبح خلاصاتك جاهزة للمراجعة.
تقييم Google للخلاصات
بعد تحميل خلاصاتك، تعالج Google هذه الخلاصات وتُقيّمها من حيث الجودة
والاكتمال. نأخذ في الاعتبار العوامل التالية:
أن تتطابق الخلاصات مع مواصفات الخلاصة
تتضمّن الخلاصات جميع الحقول المطلوبة.
يتطابق إجمالي عدد التجّار في الخلاصات مع العدد الذي تمت مناقشته مع
Google.
يتم تحديد خدمة واحدة على الأقل لكل تاجر.
يتطابق إجمالي عدد الخدمات في الخلاصات مع العدد الذي تمت مناقشته مع
Google.
تتضمّن كل خدمة waitlist_rules.
نتحقّق من عدد التجّار المقدّمين الذين يمكن مطابقتهم مع
العناصر على "خرائط Google".
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRegularly provide Merchant and Service feeds to Google in JSON format, keeping each shard under 200MB and using \u003ccode\u003ePROCESS_AS_COMPLETE\u003c/code\u003e processing instruction.\u003c/p\u003e\n"],["\u003cp\u003eUpload feeds to the sandbox SFTP dropbox (\u003ccode\u003esftp://partnerupload.google.com:19321\u003c/code\u003e) for testing and validation before uploading to the production environment.\u003c/p\u003e\n"],["\u003cp\u003eGoogle evaluates feeds for quality and completeness based on factors including feed specification adherence, required fields, merchant and service counts, waitlist rules, and Google Maps matching.\u003c/p\u003e\n"],["\u003cp\u003eEnsure consistent, error-free feed uploads in the sandbox before moving to production, starting with a full Merchant feed for Google Business listing matching at least a week before launch.\u003c/p\u003e\n"],["\u003cp\u003eMonitor feed status and address errors using the Feeds page in the Partner Portal and confirm data correctness using the sandbox frontend.\u003c/p\u003e\n"]]],["Feeds, containing merchant and service data, must be provided to Google every 24 hours, using JSON format and protocol buffer 3 syntax, to display data on Google. Include metadata and process as complete. Each feed can contain shards, under 200MB compressed, uploaded to an SFTP server. Regularly upload to the sandbox for testing, then production. After uploading, monitor the \"Feeds\" page and \"Inventory Summary\" for errors, using the partner portal, ensuring data correctness and following content guidelines. Google will review the feeds.\n"],null,["# Step 2: Export feeds\n\nCreate feeds\n------------\n\nFeeds must be provided to Google on a regular basis for the data to be directly shown on Google.\nThe following feeds are needed.\n\n| Feed | Description | Frequency |\n|----------------------------------------------------------------------------------------------|-------------------------------------------|---------------------|\n| [Merchants](/actions-center/verticals/reservations/waitlists/reference/feeds/merchants-feed) | Describes your merchants. | Once every 24 hours |\n| [Services](/actions-center/verticals/reservations/waitlists/reference/feeds/services-feed) | Describes services your merchants provide | Once every 24 hours |\n\n| **Objective:** When you provide service names and descriptions, adhere to our [Content editorial guidelines](/actions-center/verticals/reservations/waitlists/support#content-guidelines).\n\nIn each feed, include\n[metadata](/actions-center/verticals/reservations/waitlists/reference/feeds/feed-metadata) that instructs Google on how to interpret it.\n| **Note:** All feeds must be uploaded with processing_instruction `PROCESS_AS_COMPLETE`. `PROCESS_AS_INCREMENTAL` is deprecated and cannot be used.\n\nThe feeds format is described with the\n[protocol buffer 3 syntax](/protocol-buffers/docs/proto3) but you can upload your feeds\nas the corresponding JSON format.\n\nPlease reference the\n[Feed samples](/actions-center/verticals/reservations/waitlists/reference/feeds/overview) to see the JSON format.\n\nWe recommend that you upload the feeds in JSON format.\n\nFeed file size, sharding, and compression\n-----------------------------------------\n\nPlease view the following tutorials regarding compression and shards:\n\n- [Compress feed files](/actions-center/verticals/reservations/waitlists/reference/tutorials/compression)\n- [Shard feed files](/actions-center/verticals/reservations/waitlists/reference/tutorials/sharding)\n\nTo determine the size of the feeds, use the following guidelines (a feed can be constituted\nof multiple files called \"shards\"):\n\n- Suggested feed sharding:\n - Merchants feed: 1 shard\n - Services feed: 1 shard\n- Size of feed files and sharding:\n - Keep shard file size below 200 MB (after compression). Use multiple shards if needed.\n - Individual records sent in one shard don't need to be sent in the same shard in future feeds.\n - For better performance, split data evenly among the shards, to make all the shard files similar in size.\n - If necessary, use gzip to compress plain text JSON feeds. However, do so for each individual feed shard.\n\nUpload the feeds to the SFTP Server\n-----------------------------------\n\nUpload your feeds to the sandbox environment. To do so, refer to the\nusernames within the\n[Partner Portal feed configuration](/actions-center/verticals/reservations/waitlists/partner-portal/testing/feeds) page. The Google SFTP server is\navailable at `sftp://partnerupload.google.com` on port\n`19321`.\n| **Warning:** Upload your feeds to the production servers only after Google has tested and confirmed your feeds in the sandbox environment.\n| **Note:** To access the sandbox, make sure that the [environment switcher](/actions-center/verticals/reservations/waitlists/partner-portal/overview/environment-switcher) on the top is set to Sandbox and go to **[Inventory \\\u003e Inventory](https://partnerdash.google.com/apps/reservewithgoogle/inventory?env=sandbox)**, find a merchant that is either \"Ready\" or \"Live (in Sandbox)\" then either click on the link on the rightmost column (if available) or click on the row and click on the \"RwG - E2E\" link.\n\nWe recommend that you give the files you upload unique names. For instance,\nit can be helpful to append each filename with a timestamp. This helps to\ntroubleshoot issues and query for feed status.\n| **Note:** Google processes feed files as soon as they're uploaded to the SFTP server. If the feed is sharded across multiple files, they are processed after you upload the last file. If your feed contains errors, an email is sent to you with the [feed error codes](/actions-center/verticals/reservations/waitlists/reference/feeds/feed-errors).\n\nConfirm that your data looks correct\n------------------------------------\n\nSign in to the Partner Portal. Toggle to the **Sandbox** environment to\nfind the following pages in the **Dashboards** section.\n\n[Feeds](https://partnerdash.google.com/apps/reservewithgoogle/dashboards/feeds?activeTab=feeds&env=sandbox)\n: Shows the feed summary statistics and points out errors during feed\n upload.\n\nTo confirm that your data looks correct after your initial upload to the\nsandbox environment, check the\n**[Feeds](https://partnerdash.google.com/apps/reservewithgoogle/dashboards/feeds?activeTab=feeds&env=sandbox)**\npage for any feed errors.\n\nThen check the **Inventory Summary** page for any data issues.\nCommon issues include uploading merchants without any services or uploading services\nwithout any availability slots in the future.\n\nThe sandbox frontend, which emulates the live UI experience, shows how the\ndata will look from the user's perspective. To access it, make sure that the\n[environment switcher](/actions-center/verticals/reservations/waitlists/partner-portal/overview/environment-switcher) on the top is\nset to Sandbox and go to\n**[Inventory \\\u003e Inventory](https://partnerdash.google.com/apps/reservewithgoogle/inventory?env=sandbox)**, find a merchant that is either \"Ready\" or \"Live (in Sandbox)\" then either click on the link\non the rightmost column (if available) or click on the row and click on the \"RwG - E2E\" link. If\nthere is no merchant with status \"Ready\" or \"Live (in Sandbox)\", open a disabled merchant and make\nsure to fix all the issues listed on the right (such as making sure future availability have been\nuploaded).\n| **Note:** Our system matches the merchants that you send us to merchants already listed on Google Maps. In the sandbox, we perform only automated matches for your merchants. In production, the process may involve human review. Therefore, matches in the sandbox don't reflect the matches made in production, which are more stringent.\n\nIf you can't access the sandbox frontend, confirm that you are signed in\nwith an account that has been given access to the frontend. Also be sure that\nthis is the only account you are signed in to. If you sign in with a\ndifferent account and then use the Switch User feature to sign in to the\napproved Google account, you are still blocked from the sandbox frontend.\n\nUpload your feeds to production\n-------------------------------\n\nOnce you are able to consistently upload complete, error-free feeds to the\nSandbox environment you may begin uploading to the Production environment.\nAt this point your integration will **not** be live.\n\nPlease upload a full **Merchant feed** as soon as possible (minimum\n1 week before launch), so you can begin matching your merchants to a Google\nbusiness listing. Please verify the matching correctness.\n\nOnce **all** your production feed data is uploading consistently\nand connected to your production system, your feeds are ready for review.\n\nGoogle evaluates feeds\n----------------------\n\nOnce you upload your feeds, Google processes and evaluates them for quality\nand completeness. We look at the following factors:\n\n1. Feeds match the feed specification.\n2. Feeds include all the required fields.\n3. The total number of merchants in feeds matches the number discussed with Google.\n4. At least one service is defined for each merchant.\n5. The total number of services in feeds matches the number discussed with Google.\n6. Each service includes `waitlist_rules`.\n7. We check how many of the merchants provided can be matched against features on Google Maps.\n\n| **Note:** As you submit your feeds, work through items 1-5 to ensure a smooth integration."]]
