وبلاگ ها: getByUrl
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک وبلاگ را با URL بازیابی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
اگر وبلاگ خصوصی است مجوز لازم است. اگر وبلاگ عمومی است، این روش را می توان بدون مجوز فراخوانی کرد.
درخواست کنید
درخواست HTTP
GET https://www.googleapis.com/blogger/v3/blogs/byurl
پارامترها
نام پارامتر | ارزش | توضیحات |
---|
پارامترهای مورد نیاز |
url | string | آدرس وبلاگ برای بازیابی. |
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش یک منبع Blogs را در بدنه پاسخ برمی گرداند.
نمونه ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه کلاینت جاوا استفاده می کند
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());
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-08 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]