المدونات: getByUrl
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لاسترداد مدونة باستخدام عنوان URL.
جرِّب الخدمة الآن أو اطّلِع على مثال.
يكون التفويض مطلوبًا إذا كانت المدونة خاصة. إذا كانت المدونة علنية، يمكن طلب هذه الطريقة بدون إذن.
الطلب
طلب HTTP
GET https://www.googleapis.com/blogger/v3/blogs/byurl
المعلمات
اسم المعلَمة |
القيمة |
الوصف |
المَعلمات المطلوبة |
url |
string |
تمثّل هذه السمة عنوان URL للمدوّنة الذي تريد استرداده.
|
نص الطلب
لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، سيتم عرض مورد المدونات في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
Java
لاستخدام مكتبة برامج Java
String CODE_BLOG_URL = "http://code.blogger.com/";
// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();
// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
JSON_FACTORY, new LocalServerReceiver(),
Arrays.asList(BloggerScopes.BLOGGER));
// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
.setApplicationName("Blogger-BlogGetByUrl-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action object.
GetByUrl blogGetByUrlAction = blogger.blogs().getByUrl();
// Configure which blog URL to look up.
blogGetByUrlAction.setUrl(CODE_BLOG_URL);
// Restrict the result content to just the data we need.
blogGetByUrlAction.setFields("description,name,posts/totalItems,updated");
// This step sends the request to the server.
Blog blog = blogGetByUrlAction.execute();
// Now we can navigate the response.
System.out.println("Name: " + blog.getName());
System.out.println("Description: " + blog.getDescription());
System.out.println("Post Count: " + blog.getPosts().getTotalItems());
System.out.println("Last Updated: " + blog.getUpdated());
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-09 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a blog's details using its URL.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization for private blogs, but public blogs can be accessed without authorization.\u003c/p\u003e\n"],["\u003cp\u003eUses a simple \u003ccode\u003eGET\u003c/code\u003e request with the blog's URL as a required parameter.\u003c/p\u003e\n"],["\u003cp\u003eReturns a comprehensive \u003ccode\u003eBlogs\u003c/code\u003e resource containing information about the blog if the request is successful.\u003c/p\u003e\n"],["\u003cp\u003eOffers code examples in Java to demonstrate how to use the API to retrieve blog information.\u003c/p\u003e\n"]]],[],null,["# Blogs: getByUrl\n\nRetrieves a blog by URL.\n[Try it now](#try-it) or [see an example](#examples).\n\n[Authorization](/blogger/docs/3.0/using#auth) is required if the blog is private. If the blog is public, then this method can be called without authorization.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/blogs/byurl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|----------------------------------|\n| **Required parameters** |||\n| `url` | `string` | The URL of the blog to retrieve. |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [Blogs resource](/blogger/docs/3.0/reference/blogs#resource) in the response body.\n\nExamples\n--------\n\n**Note:** The code examples available for this method do not represent all supported programming languages (see the [client libraries page](/blogger/docs/3.0/libraries) for a list of supported languages). \n\n### Java\n\nUses the [Java client library](http://code.google.com/p/google-api-java-client/) \n\n```java\nString CODE_BLOG_URL = \"http://code.blogger.com/\";\n\n// Configure the Java API Client for Installed Native App\nHttpTransport HTTP_TRANSPORT = new NetHttpTransport();\nJsonFactory JSON_FACTORY = new JacksonFactory();\n\n// Configure the Installed App OAuth2 flow.\nCredential credential = OAuth2Native.authorize(HTTP_TRANSPORT,\n\tJSON_FACTORY, new LocalServerReceiver(),\n\tArrays.asList(BloggerScopes.BLOGGER));\n\n// Construct the Blogger API access facade object.\nBlogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)\n\t.setApplicationName(\"Blogger-BlogGetByUrl-Snippet/1.0\")\n\t.setHttpRequestInitializer(credential).build();\n\n// The request action object.\nGetByUrl blogGetByUrlAction = blogger.blogs().getByUrl();\n\n// Configure which blog URL to look up.\nblogGetByUrlAction.setUrl(CODE_BLOG_URL);\n\n// Restrict the result content to just the data we need.\nblogGetByUrlAction.setFields(\"description,name,posts/totalItems,updated\");\n\n// This step sends the request to the server.\nBlog blog = blogGetByUrlAction.execute();\n\n// Now we can navigate the response.\nSystem.out.println(\"Name: \" + blog.getName());\nSystem.out.println(\"Description: \" + blog.getDescription());\nSystem.out.println(\"Post Count: \" + blog.getPosts().getTotalItems());\nSystem.out.println(\"Last Updated: \" + blog.getUpdated());\n```\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]